Skip to content

README.md

Latest commit

 

History

History
94 lines (71 loc) · 1.82 KB

README.md

File metadata and controls

94 lines (71 loc) · 1.82 KB

time-mcp

A local MCP (Model Context Protocol) server for time-related tools. 100% local—no external APIs, just your system clock.

Tools

Tool Description
get_current_time Get current date/time in any timezone and format
convert_timezone Convert time between timezones
time_difference Calculate duration between two times
list_timezones List common IANA timezone identifiers

Installation

git clone https://github.com/twalderman/time-mcp.git
cd time-mcp
npm install
npm run build

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "time": {
      "command": "node",
      "args": ["/path/to/time-mcp/dist/index.js"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "time": {
      "command": "node",
      "args": ["/path/to/time-mcp/dist/index.js"]
    }
  }
}

Coffee Shop (Obsidian Plugin)

In Obsidian Settings → Coffee Shop → Services → MCP:

  • Name: Time
  • Type: stdio
  • Command: node $HOME/Projects/time-mcp/dist/index.js

Usage Examples

Get current time:

{ "timezone": "America/New_York", "format": "human" }

→ Monday, February 3, 2026 at 02:18:32 PM EST

Convert timezone:

{ "time": "2026-02-03T14:00:00", "from_timezone": "America/New_York", "to_timezone": "Asia/Tokyo" }

Time until event:

{ "to_time": "2026-12-25T00:00:00" }

→ 325 days, 9 hours, 41 minutes from now

Formats

Format Output
iso 2026-02-03T14:18:32.000Z
human Monday, February 3, 2026 at 02:18:32 PM EST
unix 1770242312
date Monday, February 3, 2026
time 02:18:32 PM EST

License

MIT