time-mcp
An MCP server that returns the local current time and the current time in any IANA timezone.
Tools
| Tool | Arguments | Returns | Description |
|---|---|---|---|
get_local_time |
(none) | time object | Current date and time of the machine running the server |
get_time_in_timezone |
timezone (string, required) — IANA name, e.g. Asia/Tokyo |
time object | Current date and time in the given timezone. Errors if the name is unknown |
list_timezones |
query (string, optional, default "") — case-insensitive substring; empty returns all |
string[] |
Available IANA timezone names, max 200 results |
The time object returned by get_local_time and get_time_in_timezone:
| Field | Type | Example |
|---|---|---|
timezone |
string | Asia/Tokyo |
datetime |
string (ISO 8601) | 2026-09-05T14:10:32.637530+09:00 |
date |
string | 2026-09-05 |
time |
string | 14:10:32 |
weekday |
string | Saturday |
utc_offset |
string | +0900 |
unix_timestamp |
integer | 1788585032 |
Install
pip install time-mcp
Or run it without installing:
uvx time-mcp
Development setup
uv sync
Try it
uv run mcp dev src/time_mcp/server.py
Register with Claude Code
claude mcp add time -- uv --directory /Users/kujirahand/repos/mcp_server-time run time-mcp
Or in claude_desktop_config.json:
{
"mcpServers": {
"time": {
"command": "uv",
"args": ["--directory", "/Users/kujirahand/repos/mcp_server-time", "run", "time-mcp"]
}
}
}
License
MIT License. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
time_mcp-0.1.0.tar.gz
(66.4 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file time_mcp-0.1.0.tar.gz.
File metadata
- Download URL: time_mcp-0.1.0.tar.gz
- Upload date:
- Size: 66.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a6fbdde0b7302032c28d36c694135340f3596779b205432a8ccd7a78643f552
|
|
| MD5 |
22490aebaaee09a0dd012311d519fa48
|
|
| BLAKE2b-256 |
8208e04823f2c8bd8f2b28cede93d967a6452ab627718d1d8f6cd59726571486
|
File details
Details for the file time_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: time_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 4.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d4b059df8fe0565928104236d19d5f97928d090de328c4fe8d369b0be0e2be1f
|
|
| MD5 |
1cb25689f12dc1caeb2a97f5b960e42a
|
|
| BLAKE2b-256 |
51b6c4816de20958ab7564192111baa580a228e77ba302599016ba50c63977e2
|
