time-mcp

MCP server - make Claude tell the time! Highly reliable and consistent.

Catalog onlyCatalog onlySTDIO

Overview

Time-mcp is a server that provides real-time timezone-aware date and time information using the Claude Model Configuration Protocol (MCP).

To use time-mcp, clone the repository, set up a virtual environment, install the package, and run the server locally to make the time tool available to Claude.

Get current time in any IANA timezone - Easy integration with Claude AI through MCP - Comprehensive timezone support using Python's zoneinfo module - Simple JSON responses in ISO format

Providing real-time time information for applications that require timezone awareness.
Integrating with AI systems to enhance their capabilities with accurate time data.
Supporting developers in building applications that need reliable time information across different regions.

Add to your AI client

Use these steps to connect time-mcp in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "time-mcp-samay58": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "time-mcp-samay58": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "time-mcp-samay58": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "time-mcp-samay58": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "time-mcp-samay58": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "time-mcp-samay58": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-samay58"
      ]
    }
  }
}

FAQ

What programming language is time-mcp built with?

Time-mcp is built using Python 3.10+.

How can I get the current time in a specific timezone?

Use the `get_current_time` tool with the desired IANA timezone as a parameter.

Is there any license for using time-mcp?

Yes, time-mcp is licensed under the MIT License.

Research and data