Skip to content

MCP server

Time MCP server

The MCP project's Time reference server gives AI the current time in any time zone and converts times between zones.

At a glance

Maintained by
Model Context Protocol project (Anthropic reference servers)
Tools exposed
2 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Language models do not know what time it is, and they often get time zone conversions wrong, especially around daylight saving changes. The Time server gives an assistant two reliable tools: the current time in a given zone, and conversion of a time from one zone to another.

It is small, but it prevents a common class of mistakes in scheduling, reminders and anything with deadlines across regions.

This is a reference server from the Model Context Protocol project. Reference servers show how the protocol works and are useful for learning and prototypes. Check the project notes before relying on one in production. It has no outside access and returns only time data, so the risk is minimal. It pairs well with calendar servers when teams work across time zones.

For teams spread across several countries, this is a quick win. Meeting proposals, deadlines and reminders all become more reliable when the assistant checks the clock instead of guessing.

It also helps automated workflows. An agent that sends reminders or checks due dates can confirm the current time before acting, rather than relying on the date in its instructions.

Use cases

Best business use cases

Scheduling

Propose meeting times that work across zones. See appointment scheduling.

Deadlines

State deadlines correctly for each region.

Global teams

Answer "what time is it for the Karachi team now".

Reminders

Set reminders in the right zone.

Travel

Convert arrival times for travel plans.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Read only: returns time data; no outside access.

  • get_current_time

    Get the current time in an IANA time zone.

  • convert_time

    Convert a time between two time zones.

Workflows

Example workflows

Schedule across three offices

  1. 1

    Give the office locations.

  2. 2

    The assistant gets the current time in each.

  3. 3

    It proposes slots in working hours for all.

  4. 4

    It converts each slot to local times.

  5. 5

    You pick one and book it.

Confirm a deadline

  1. 1

    A client gives a deadline in their time zone.

  2. 2

    The assistant converts it to yours.

  3. 3

    It notes any daylight saving change.

  4. 4

    It adds the correct time to your task.

  5. 5

    Everyone sees the same deadline.

Prompts

Example prompts

  • “What time is it now in New York, London and Karachi?”

  • “Convert 3 p.m. Friday Sydney time to Pakistan time.”

  • “Find a one-hour slot in working hours for teams in Dubai and Chicago.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

{
    "mcpServers": {
        "time": {
            "command": "uvx",
            "args": [
                "mcp-server-time"
            ]
        }
    }
}

Claude Code: terminal

claude mcp add time -- uvx mcp-server-time
  • Local server: stdio; mcp-server-time; uvx mcp-server-time; mcp/time.

Security

Security considerations

  • No outside access

    It only returns time data.

  • Reference server

    Treat it as a reference implementation.

  • Check key times

    Confirm important deadlines with people.

  • Pair with calendars

    Use calendar servers for actual bookings.

Related servers

Servers that pair well with it

Google Calendar

Google's own Calendar MCP server lets AI list calendars and events, create, update and delete events, respond to invites and suggest times.

Sequential Thinking

The MCP project's Sequential Thinking reference server gives AI a structured way to break a problem into steps and revise them.

Everything

The MCP project's Everything server is a test server that shows every protocol feature. For building and testing MCP clients only.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.