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"

Related MCP server: FreeAgent MCP Server

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