TimeMCP

What is TimeMCP?

TimeMCP is a Model Control Protocol (MCP) server that provides current time retrieval and timezone conversion tools. It is built in Go and exposes two tools: get_current_time and convert_time. It is intended for developers using MCP-compatible clients (e.g., Claude Desktop) who need to handle time data across timezones.

How to use TimeMCP?

Build the server from source with go build -o ./bin/mcp-time ., then add it to your MCP client configuration (e.g., claude_desktop_config.json) by specifying the path to the binary under mcpServers.time.command. Once connected, the client can discover and call the provided tools with the required arguments.

Key features of TimeMCP

• get_current_time: returns the current time in an optional timezone (defaults to system timezone)
• convert_time: converts a time from one timezone to another
• Supports all IANA time zone database entries (e.g., Europe/Warsaw, America/New_York)
• Lightweight Go implementation with minimal dependencies
• Works with any MCP-compatible client

Use cases of TimeMCP

• Displaying the current time in a specific IANA timezone
• Converting a meeting time from one timezone to another
• Integrating time-aware responses into an AI assistant’s workflow
• Validating and formatting time strings across different regions

FAQ from TimeMCP

What dependencies does TimeMCP require?

TimeMCP depends on github.com/mark3labs/mcp-go (MCP implementation) and github.com/araddon/dateparse (flexible date parsing). It is written in Go.

Which timezones are supported?

The server supports all IANA time zone database entries, such as Europe/Warsaw, America/New_York, Asia/Tokyo, Australia/Sydney, and Africa/Cairo.

How do I build and run TimeMCP?

Run go build -o ./bin/mcp-time . in the project root, then reference the resulting binary in your MCP client’s configuration under mcpServers.time.command.

Do I need a network connection to use TimeMCP?

No, the server runs locally and uses built-in timezone data. It does not call any external APIs.

What MCP clients are compatible with TimeMCP?

Any client that implements the Model Control Protocol (e.g., Claude Desktop) can discover and call the server’s tools.