what is Time-MCP?
Time-MCP is an MCP server designed to provide agents with the current time and date, enabling them to perform time-dependent tasks effectively.
how to use Time-MCP?
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.
key features of Time-MCP?
- Provides current time and date information.
- Offers two tools:
get_datetimeandget_current_unix_timestamp. - Supports multiple time zones.
use cases of Time-MCP?
- Answering queries about the current time in different locations.
- Assisting agents in scheduling tasks based on time.
- Providing timestamps for events in applications.
FAQ from Time-MCP?
- 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.
Time-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.
