Time-MCP

Name: Time-MCP
Author: sidharthrajaram

@sidharthrajaram

Repository

About Time-MCP

mcp server for the time and date

#time-mcp #mcp-server #time-and-date

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "time": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/time-mcp",
        "run",
        "time_mcp_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Time-MCP?

Time-MCP is a Model Context Protocol server that enables agents to retrieve the current date and time via two tools, get_datetime and get_current_unix_timestamp. It is designed for agents that need to know the current time in any timezone or the current UNIX timestamp.

How to use Time-MCP?

For Claude Desktop, add the server to claude_desktop_config.json using uv with the path to time_mcp_server.py. For custom clients (or Linux), implement an STDIO‑based client following the official MCP client tutorial and use time_mcp_server.py as the server.

Key features of Time-MCP

Returns current date and time in a specified timezone (defaults to UTC)
Provides the current UNIX timestamp
Lightweight, single‑file Python server
STDIO transport for easy integration
Works with Claude Desktop and custom clients
Requires only Python and uv

Use cases of Time-MCP

Answering “what time is it?” in a given timezone
Calculating time offsets for future weather forecasts
Timestamping agent actions or events
Supporting time‑dependent task scheduling

FAQ from Time-MCP

What tools does Time-MCP provide?

It provides two tools: get_datetime returns the current date and time in a specified timezone (UTC if none), and get_current_unix_timestamp returns the current UNIX timestamp.

What dependencies does Time-MCP require?

The server requires Python and the uv package manager. It is a single Python script.

How do I set up Time-MCP in Claude Desktop?

Add a "time" entry to the mcpServers section of claude_desktop_config.json with the command uv and arguments pointing to the time_mcp_server.py file. The full path to uv may be needed.

What transport does Time-MCP use?

Time-MCP uses STDIO transport, the standard for MCP servers.

Can I use Time-MCP with a custom client?

Yes. Implement an STDIO‑based MCP client (following the official example tutorial) and connect it to time_mcp_server.py instead of the example weather server.