How do I use Date MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Date MCP Server what's the current date and time in Tokyo?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Date MCP Server

by ainarsklavins

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

@ainarsklavins/date-mcp

An MCP server that provides real-time date, time, and timezone information to AI assistants.

Why Use This?

AI models don't inherently know the current date or time. This MCP server solves that by providing tools that return accurate, real-time temporal information.

Installation

Claude Desktop

Add to your Claude Desktop configuration file:

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

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

Claude Code (CLI)

claude mcp add --scope user date-mcp -- npx -y @ainarsklavins/date-mcp

Add to ~/.claude/settings.json:

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

VS Code

Or manually add to your VS Code MCP settings (Ctrl+Shift+P → "MCP: Open User Configuration"):

{
  "servers": {
    "date-mcp": {
      "command": "npx",
      "args": ["-y", "@ainarsklavins/date-mcp"]
    }
  }
}

Cursor

Add to Cursor's MCP settings (Settings → MCP Servers):

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

npm install -g @ainarsklavins/date-mcp

Then use "command": "date-mcp" instead of npx in any configuration above.

Available Tools

Tool	Description	Read-only
`get-current-datetime`	Get current date/time with timezone	Yes
`get-day-of-week`	Get day name for any date	Yes
`get-timezone-info`	Get timezone offset and details	Yes
`format-date`	Format dates in various styles	Yes

All tools are read-only and have no side effects.

get-current-datetime

Returns the current date and time.

Parameters:

Name	Type	Required	Description
`timezone`	string	No	IANA timezone (e.g., `America/New_York`)

Example:

{
  "iso": "2024-12-15T14:30:00.000Z",
  "formatted": "12/15/2024, 9:30:00 AM",
  "timezone": "America/New_York",
  "timestamp": 1734272200000
}

get-day-of-week

Returns the day of the week for a given date.

Parameters:

Name	Type	Required	Description
`date`	string	No	Date in YYYY-MM-DD format (defaults to today)
`locale`	string	No	Locale code (e.g., `en-US`, `de-DE`)

Example:

{
  "dayName": "Sunday",
  "dayNumber": 0,
  "date": "2024-12-15"
}

get-timezone-info

Returns detailed timezone information.

Parameters:

Name	Type	Required	Description
`timezone`	string	No	IANA timezone name

Example:

{
  "timezone": "America/New_York",
  "offset": "GMT-05:00",
  "abbreviation": "EST",
  "currentTime": "12/15/2024, 9:30:00 AM"
}

format-date

Formats a date in various styles.

Parameters:

Name	Type	Required	Description
`date`	string	No	Date in ISO format (defaults to today)
`style`	string	No	`short`, `medium`, `long`, or `full`
`locale`	string	No	Locale code (e.g., `en-US`, `fr-FR`)

Example:

{
  "formatted": "December 15, 2024",
  "style": "long",
  "locale": "en-US",
  "iso": "2024-12-15T00:00:00.000Z"
}

Supported Timezones

Uses IANA timezone database. Common examples:

America/New_York, America/Los_Angeles, America/Chicago
Europe/London, Europe/Paris, Europe/Berlin
Asia/Tokyo, Asia/Shanghai, Asia/Singapore
Australia/Sydney
UTC

Full list: IANA Time Zone Database

Debugging

You can use the MCP Inspector to debug the server:

npx @modelcontextprotocol/inspector npx -y @ainarsklavins/date-mcp

Development

git clone https://github.com/ainarsklavins/date-mcp.git
cd date-mcp
npm install
npm run build

Testing Locally

Add to Claude Code with direct path:

{
  "mcpServers": {
    "date-mcp": {
      "command": "node",
      "args": ["/path/to/date-mcp/dist/index.js"]
    }
  }
}

License

MIT - see LICENSE

Available Tools

4 tools

format-dateFormat DateC

Format a date in various styles (short, medium, long, full).

Inputs: date, style, locale.

get-current-datetimeGet Current Date and TimeA

Returns the current date and time. Optionally specify a timezone.

Inputs: timezone.

get-day-of-weekGet Day of WeekB

Returns the day of the week for a given date or today.

Inputs: date, locale.

get-timezone-infoGet Timezone InformationB

Returns information about the current or specified timezone.

Inputs: timezone.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.6/5.0

Scored 2026-04-18 08:00 across 4 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: formatting dates, getting current datetime, determining day of week, and retrieving timezone information. There is no overlap in functionality, and an agent can easily select the correct tool based on the specific need.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with hyphens (e.g., format-date, get-current-datetime, get-day-of-week, get-timezone-info). The naming is predictable and readable throughout the set.

Tool Count5/5

With 4 tools, the server is well-scoped for handling date and time operations. Each tool serves a unique and essential function, and the count is appropriate for the domain without being too thin or bloated.

Completeness4/5

The tool set covers core date/time operations like formatting, current datetime retrieval, day-of-week calculation, and timezone info. A minor gap is the lack of date arithmetic or manipulation tools (e.g., add days, compare dates), but agents can work around this with the provided tools.

Resources

Related MCP Connectors

time-mcpA
io.github.jmavid
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Developer Tools
2
https://time-mcp.jmavid.workers.dev/mcp
timeA
pro.worldclock
A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.
Developer Tools
52
https://worldclock.pro/mcp
Epoch CalculatorA
com.epochcalc
Time and date math for AI agents: Unix timestamp conversion, DST-correct time zone conversion, durations, epoch arithmetic, cron schedules, and holiday countdowns. Eight tools, no key.
Calendar Management Developer Tools Workplace & Productivity
81
https://epochcalc.com/mcp
chrono-mcpA
io.github.nexus-api-lab
Deterministic time tools for AI agents: timezone conversion, business-day math, cron interpretation.
Developer Tools Calendar Management
2
https://chrono-mcp.dokasukadon.workers.dev/mcp

Appeared in Searches

A tool for telling the current time