About Time-MCP
Time-MCP is a small MCP server for agents that need the current date and time. It provides timezone-aware datetime output and a UNIX timestamp.
Key features
- 01Get formatted date and time
- 02Specify a timezone
- 03Get current UNIX timestamp
Use cases
- 01Answer questions about the current local time
- 02Support tasks that depend on the current date
- 03Calculate timing for time-sensitive requests
MCP support
The STDIO-based MCP server exposes `get_datetime` and `get_current_unix_timestamp` tools to agents and MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETime-MCP
This is an MCP server for agents to get the current time (and date).
Usage
Claude Desktop App
Add time_mcp_server.py to the list of MCP servers in the Claude Desktop App config file at ~/Library/Application\ Support/Claude/claude_desktop_config.json like this:
{
"mcpServers": {
"time": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/time-mcp",
"run",
"time_mcp_server.py"
]
}
}
}
Save the file, and restart Claude for Desktop.
Note: You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.
This is based on Testing your server with Claude for Desktop from https://modelcontextprotocol.io/quickstart/server.
Custom client (or Linux)
Since this is an STDIO-based MCP server, the best way is to implement a client in a similar fashion as the official example client tutorial (https://modelcontextprotocol.io/quickstart/client). Instead of the example weather.py MCP server, use time_mcp_server.py.
Why?
It seems helpful and kind of important for agents to know what time (and date) it is. Enables agents to fulfill time-dependent tasks such as "what time is it in Pacifica?" or "what will the weather be 3 hours from now?"
Tools
Time-MCP provides two tools, get_datetime and get_current_unix_timestamp which return a formatted datetime in the specified timezone (UTC if none specified) and the current UNIX timestamp, respectively.
With/Without Time-MCP:
Without:
With:
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.