MCP Time Server

The MCP Time Server provides the current time for a requested timezone and can be used by clients across transports. It supports both a local STDIO runtime and an HTTP Streamable Transport, making it easy to integrate time data into your applications or workflows.

How to use

You can access the current time from a client by targeting either the local STDIO server or the HTTP endpoint. The server returns the time in the timezone you specify (default is Asia/Shanghai). You can use standard IANA timezone names such as UTC or America/New_York.

How to install

pip install .

After installation, you can start the server in STDIO mode or in HTTP mode.

mcp-server-time

uv run mcp-server-time

To expose the server via HTTP, run the HTTP variant and open the base URL in a browser or API client. The server will be available at http://localhost:8000 once started with a web server adapter.

Notes and usage considerations

Timezone support uses standard IANA names. If you don’t specify a timezone, the default Asia/Shanghai is used. You can query the current time for any supported timezone by providing it to the appropriate endpoint or operation in your MCP client.

Transports supported:

• STDIO: run directly in your environment as a local server
• HTTP Streamable Protocol: accessible via an HTTP endpoint when started with a web server adapter (e.g., uvicorn) at http://localhost:8000.

Available tools

get_current_time

Returns the current time in the specified timezone. If no timezone is provided, the default timezone Asia/Shanghai is used. Supports standard IANA timezone names such as UTC, America/New_York, etc.