MCP Time

What TheoBrigitte/mcp-time MCP server does

TheoBrigitte/mcp-time MCP server exposes date and time operations through the Model Context Protocol. It is intended for MCP clients that need to answer time-related questions, interpret relative date expressions, or perform calculations across timezones. The implementation supports both local client connections and network access through its stream transport.

The server can return the current time, interpret expressions such as “5 minutes ago” or “next month,” add or subtract durations, convert values between timezones, and compare two timestamps. Output formatting can use predefined formats such as RFC3339 and Kitchen, or custom Go time layouts where supported by the tool.

How it works

MCP clients call one of five tools. current_time produces the current time for a selected timezone and format. relative_time resolves a natural-language expression against either the current time or a supplied reference time. add_time applies a duration such as 2h30m, -1h, or 24h to an input time.

convert_timezone parses an input time and renders it in another timezone. Input and output timezone fields are optional where the server can use its defaults. compare_time evaluates two values, including timezone information when provided, and returns -1, 0, or 1 to indicate whether the first value is earlier than, equal to, or later than the second.

Setup and configuration

TheoBrigitte/mcp-time MCP server can be launched through the published npm package with Node.js installed:

{
  "mcpServers": {
    "mcp-time": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theo.foobar/mcp-time"]
    }
  }
}

Docker is another documented stdio option, using the theo01/mcp-time:latest image. A native mcp-time binary can also be installed from the project releases, with Go, or by building the repository. The default transport is stdio. For network use, start the binary with --transport stream; --address controls the stream HTTP endpoint and defaults to http://localhost:8080/mcp. Logging can be enabled with --log-file.

Tools and capabilities

The available capabilities are:

• Read the current time in an IANA timezone.
• Resolve relative natural-language dates and times.
• Add or subtract durations from an input time.
• Convert times between source and destination timezones.
• Compare timezone-aware time values.
• Format results with predefined or custom layouts.

Limitations and notes

The server is focused on time and date operations rather than calendars, reminders, scheduling, or external clock and calendar services. It does not require credentials or an external API key according to the documented setup. Timezone-aware requests should use IANA timezone names when the relevant tool parameter calls for them, such as America/New_York or Europe/London.

The project documents compatibility with MCP clients including Cursor and Claude Desktop. It also lists Claude Code and other MCP clients as possible integrations, but client-specific configuration may vary. The repository is licensed under MIT.