e_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: Screenshot 2025-03-20 at 1 02 21 AM

##### With: Screenshot 2025-03-20 at 1 02 54 AM

29:T49d,## 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_datetime` and `get_current_unix_timestamp`. - Supports multiple time zones. ## use cases of Time-MCP? 1. Answering queries about the current time in different locations. 2. Assisting agents in scheduling tasks based on time. 3. 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.2a:T76b,# 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities [![smithery badge](https://smithery.ai/badge/@yokingma/time-mcp)](https://smithery.ai/server/@yokingma/time-mcp)

A Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.

## Tools - `current_time`: Get current time (UTC and local time) - `relative_time`: Get relative time - `get_timestamp`: Get timestamp for the time - `days_in_month`: Get days in month - `convert_time`: Convert time

#time-mcp

Simple Time MCP

time-mcp

Time-MCP

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

time-mcp