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