mcp-datetime

What is mcp-datetime?

mcp-datetime is a datetime formatting service implemented as an MCP server for the Claude Desktop Application. It generates datetime strings in various formats and has been tested only on macOS.

How to use mcp-datetime?

Add the server configuration to ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, using uvx as the command with "mcp-datetime" as the argument. Once configured, use the get_datetime tool with a "format" argument (e.g., "datetime", "datetime_jp", "filename_md") to retrieve the current date and time in the desired format.

Key features of mcp-datetime

• Support for various datetime formats (standard, Japanese, ISO, compact, filename, log)
• Japanese language support for dates and times
• Optimized formats for file name generation (Markdown, text, log)
• Accurate timezone handling
• Seamless integration with the Claude Desktop App

Use cases of mcp-datetime

• Get current date and time in standard, slash-separated, or ISO 8601 formats
• Generate compact datetime strings for unique identifiers or log entries
• Create filename-friendly datetime strings for Markdown, text, or log files
• Use natural language prompts in Claude Desktop to retrieve formatted datetime (e.g., "Tell me the current time in date_slash format")

FAQ from mcp-datetime

What runtime and tools does mcp-datetime require?

Python 3.12 or later and uv (Python package installer) with uvx (Python package runner) are required.

How do I install mcp-datetime?

Install from PyPI with pip install mcp-datetime, or clone the GitHub repository and run pip install -e . for development or source code inspection.

What formats are supported?

The server supports 18 formats including date (2024-12-10), datetime (2024-12-10 00:54:01), date_jp (2024年12月10日), datetime_jp (2024年12月10日 00時54分01秒), compact (20241210005401), filename_md (20241210005401.md), iso (2024-12-10T00:54:01+0900), and log (2024-12-10 00:54:01.123456). See the README for the full list.

Is mcp-datetime tested on Windows?

No. The package has been tested only on macOS; Windows compatibility has not been verified.

How can I debug mcp-datetime?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector uvx mcp-datetime for the PyPI package, or npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime for a local clone.