Skip to content
MCP Server

TimeDate for AI Agents

Give Claude, Cursor, and any MCP-compatible AI real-time timezone, meeting, and date data. One npx command to install.

npm installsoonREST API docs
Coming soon: The @timedate/mcp package is not yet published to npm. The configs below are ready — install will work once the package is live.
QUICK INSTALL (Claude Desktop) — coming soon
{
  "mcpServers": {
    "timedate": {
      "command": "npx",
      "args": ["-y", "@timedate/mcp"]
    }
  }
}

9 Tools

get_time

Current time, UTC offset, DST status, and sun/moon data for any timezone.

"What time is it in Tokyo right now?"

convert_time

Convert a datetime between any two IANA timezones with offset info.

"Convert 3pm New York to London time"

search_cities

Search 33,000+ cities by name. Returns timezone, country, population, coordinates.

"What timezone is Kuala Lumpur in?"

get_holidays

Public holidays for any country and year. 120 countries supported.

"What are the public holidays in Japan in 2026?"

get_sunrise_sunset

Sunrise, sunset, solar noon, golden hour, and day length for any coordinates.

"When does the sun set in Paris today?"

calculate_date

Date arithmetic — diff, add/subtract, business days, ISO week numbers.

"How many business days between Jan 1 and Mar 31?"

find_meeting_time

Fair meeting times across timezones. Scores each slot 0–100 for fairness.

"Find a meeting time for New York, London, and Singapore"

score_meeting_fairness

Score how fair a proposed meeting time is for all participants. Returns fairness score (0–100), individual sacrifice scores, and comfort levels.

"Is our 2pm UTC standup fair for the team in NYC, London, and Tokyo?"

get_team_sacrifice_report

Analyze past meetings to find who sacrificed the most by attending outside business hours. Helps ensure fair rotation.

"Who has been most affected by our weekly meetings this quarter?"

Setup

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json (macOS)  ·  %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "timedate": {
      "command": "npx",
      "args": ["-y", "@timedate/mcp"]
    }
  }
}

Cursor.cursor/mcp.json in your project root

{
  "mcpServers": {
    "timedate": {
      "command": "npx",
      "args": ["-y", "@timedate/mcp"]
    }
  }
}

With API keyHigher rate limits + priority support

{
  "mcpServers": {
    "timedate": {
      "command": "npx",
      "args": ["-y", "@timedate/mcp"],
      "env": {
        "TIMEDATE_API_KEY": "your-api-key"
      }
    }
  }
}

Example prompts

“What time is it in New York, London, and Tokyo right now?”
“Find a fair meeting time for our team in Sydney, Berlin, and Chicago on Friday”
“How many business days are left in Q1 2026?”
“What public holidays does the UK have in May 2026?”
“When is golden hour in Paris tomorrow?”
“Convert 9am PST to IST and GST”
“Is our 2pm UTC standup fair for everyone on the team?”
“Who has sacrificed the most for our weekly meetings this quarter?”

Environment variables

VariableDefaultDescription
TIMEDATE_API_URLhttps://timedate.orgOverride API base URL (dev / self-hosting)
TIMEDATE_API_KEYnoneAPI key for higher rate limits
OpenAPI spec →Date Calculator →Timezone Converter →World Clock →