Time MCP Server

What is Time MCP Server?

Time MCP Server is a Swift implementation of a Model Context Protocol server that enables LLMs to access current time information in any timezone and convert times between different timezones. It is built using the MCP Swift SDK and provides tools for time queries, conversions, daylight saving time checks, and time difference calculations.

How to use Time MCP Server?

Download a pre-built binary from GitHub Releases for your platform (macOS, Linux, or Windows) and install it to a directory in your PATH, or build from source with Swift 6.0+. Configure the server for use with Claude.app, Cursor, or ChatWise via JSON settings. Launch the server with optional command-line arguments such as --transport sse (default: stdio), --port (default: 8080), or --local-timezone to override the system timezone.

Key features of Time MCP Server

• Get current time in any IANA timezone
• Convert times between timezones
• Check daylight saving time status
• Calculate time difference between timezones
• Two tools: get_current_time and convert_time

Use cases of Time MCP Server

• International meeting planning across timezones
• Travel planning with local time checks
• Remote work coordination with global teams
• Event scheduling with correct local times
• Time-sensitive operations requiring accurate local time

FAQ from Time MCP Server

What platforms does Time MCP Server run on?

It provides pre-built binaries for macOS (Apple Silicon, Intel, Universal), Linux (x86_64, ARM64), and Windows (x86_64, ARM64).

How do I configure Time MCP Server for Claude.app?

Add an entry to your Claude settings, for example: {"mcpServers": {"RealTime": {"command": "time-mcp-server", "args": ["-l", "Asia/Shanghai"]}}}.

What transport modes are supported?

The server supports stdio (default) for direct integration with LLMs and sse for web-based connections. In SSE mode, it listens on the port specified with --port (default 8080).

What timezone names should I use?

Always use proper IANA timezone names (e.g., America/New_York, Europe/London, Asia/Tokyo) rather than abbreviations.

Can I build Time MCP Server from source?

Yes. Requirements are Swift 6.0 or later and macOS 14.0 or later. Clone the repository and run make or swift build -c release.