DateTime MCP Server

A simple MCP server that provides accurate date and time information to Claude Code and Claude Desktop.

This server ensures Claude always uses the correct current date and time when creating documents, logs, or any time-sensitive content.

Features

Tools

get_current_datetime - Get the current date and time
- Supports multiple formats: ISO 8601, Unix timestamp, human-readable, or custom format
- Optional timezone parameter
get_current_date - Get only the current date
- Formats: ISO (YYYY-MM-DD), US (MM/DD/YYYY), EU (DD/MM/YYYY), or custom
get_current_time - Get only the current time
- Formats: 24-hour (HH:MM:SS), 12-hour (hh:MM:SS AM/PM), or custom
- Optional seconds display

Custom Format Support

Use format strings with these placeholders:

YYYY - 4-digit year
MM - 2-digit month
DD - 2-digit day
HH - 2-digit hour (24-hour)
mm - 2-digit minutes
ss - 2-digit seconds

Example: "YYYY-MM-DD HH:mm" → "2025-07-31 14:30"

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

For Claude Desktop

The server config was automatically added during setup. To verify:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "DateTime MCP Server": {
      "command": "node",
      "args": [
        "/path/to/your/datetime-mcp/build/index.js"
      ]
    }
  }
}

For Claude Code CLI

Add the server to Claude Code:

# Add the server
claude mcp add datetime-server node /path/to/your/datetime-mcp/build/index.js

# Verify it's loaded
claude mcp list

# View server details
claude mcp get datetime-server

To remove the server:

claude mcp remove datetime-server

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.