MCP servers / Time
Time MCP server: setup for Claude Code, Claude Desktop and Cursor
The Time server gives your AI the current time and timezone conversion. Language models do not know what time it is, so questions about today's date, or a meeting spread across timezones, otherwise get guessed. It has two tools, get_current_time and convert_time, and both use standard IANA timezone names such as Europe/London.
It only reports and converts time. It cannot set reminders or create calendar events.
- Runs with
- uvx (uv, for Python)
- Package
- mcp-server-time on PyPI
- Needs
- Python tooling: it runs through
uvx, which comes with uv. - Tools
- 2 (2 read-only)
- Source
- modelcontextprotocol/servers
- Last checked
- 2026-09-20 (server reported version 1.30.0)
Config for Time
Generated by the same code as the free builder, so it matches what you get there. Pick your client, then copy.
Needs uv installed (provides uvx).
Claude Code
Save as .mcp.json in your project root. Claude Code asks you to approve it the first time.
{
"mcpServers": {
"time": {
"command": "uvx",
"args": [
"mcp-server-time"
]
}
}
}
Or add it from a terminal instead (single quotes work in bash, zsh and PowerShell; more on this command):
claude mcp add time -- uvx mcp-server-time
Claude Desktop
Merge into claude_desktop_config.json (Settings → Developer → Edit Config), then fully quit and restart Claude Desktop.
{
"mcpServers": {
"time": {
"command": "uvx",
"args": [
"mcp-server-time"
]
}
}
}
Cursor
Save as .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects.
{
"mcpServers": {
"time": {
"command": "uvx",
"args": [
"mcp-server-time"
]
}
}
}
What it can do
These are all 2 tools the server reported when we started it and asked on 2026-09-20. The labels come from the hints each tool declares about itself.
get_current_timeread-only
Get current time in a specific timezoneconvert_timeread-only
Convert time between timezones
Watch out for
- Both tools are read-only, and it needs no key or account.
- By default it detects your system timezone. To set one yourself, add
--local-timezone=Region/Cityto the arguments (see below). - Give it IANA timezone names like
America/New_York, which is what the README documents.
Variations
Set your own timezone
Replaces the automatic detection. We started the server with this flag to confirm it is accepted.
{
"mcpServers": {
"time": {
"command": "uvx",
"args": [
"mcp-server-time",
"--local-timezone=America/New_York"
]
}
}
}
The same in Claude Code, Claude Desktop and Cursor.
Try asking
- “What time is it in Tokyo right now?”
- “Convert 9:00 AM New York time to London and Sydney.”
- “It is 4 PM in Berlin. What time is that in San Francisco?”
Related servers
- Memory: A simple knowledge graph the AI can remember things in.
- Sequential Thinking: Helps the AI work through hard problems step by step.
Building a full setup? Combine this with other servers in the config builder. Trouble connecting? See fixing connection errors.