Time-MCP

mcp server for the time and date

Catalog onlyCatalog onlySTDIO

Overview

Time-MCP is an MCP server designed to provide agents with the current time and date, enabling them to perform time-dependent tasks effectively.

To use Time-MCP, integrate the time_mcp_server.py into the MCP servers list of the Claude Desktop App or implement a custom client based on the STDIO protocol. Detailed instructions are provided in the project documentation.

Provides current time and date information. - Offers two tools: get_datetime and get_current_unix_timestamp. - Supports multiple time zones.

Answering queries about the current time in different locations.
Assisting agents in scheduling tasks based on time.
Providing timestamps for events in applications.

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-sidharthrajaram": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-sidharthrajaram"
      ]
    }
  }
}

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-sidharthrajaram": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-sidharthrajaram"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

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-sidharthrajaram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-time-mcp-sidharthrajaram"
      ]
    }
  }
}

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

What programming language is Time-MCP written in?

Time-MCP is written in Python.

Can I use Time-MCP on any operating system?

Yes, Time-MCP can be used on any OS that supports Python and the required libraries.

Is there a graphical interface for Time-MCP?

No, Time-MCP is designed as a server for agents and does not have a graphical interface.

Research and data