Home

Awesome

mcp-datetime

Python Version MCP Version License

English | ๆ—ฅๆœฌ่ชž

A datetime formatting service implemented as an MCP server for the Claude Desktop Application. Supports generation of datetime strings in various formats.

Note: This package has been tested only on macOS. Windows compatibility has not been verified.

Prerequisites

Before using mcp-datetime, ensure you have the following tools installed:

Features

MCP Server Components

Tools

The server implements one tool:

Usage with Claude Desktop App

Add the following to your config file:

Config file location (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-datetime": {
      "command": "uvx",
      "args": ["mcp-datetime"]
    }
  }
}

About Installation

If you need to install the package directly (e.g., for development or source code inspection), you can use one of these methods:

Basic Examples

Supported Formats

Format NameExampleDescription
date2024-12-10Standard date format
date_slash2024/12/10Date with slashes
date_jp2024ๅนด12ๆœˆ10ๆ—ฅJapanese date format
datetime2024-12-10 00:54:01Standard datetime
datetime_jp2024ๅนด12ๆœˆ10ๆ—ฅ 00ๆ™‚54ๅˆ†01็ง’Japanese datetime
datetime_t2024-12-10T00:54:01DateTime with T separator
compact20241210005401Compact format for IDs
compact_date20241210Compact date only
compact_time005401Compact time only
filename_md20241210005401.mdMarkdown filename
filename_txt20241210005401.txtText filename
filename_log20241210005401.logLog filename
iso2024-12-10T00:54:01+0900ISO 8601 format
iso_basic20241210T005401+0900Basic ISO format
log2024-12-10 00:54:01.123456Log format with microseconds
log_compact20241210_005401Compact log format
time00:54:01Time only
time_jp00ๆ™‚54ๅˆ†01็ง’Japanese time format

Debugging

Since MCP servers run over stdio, debugging can be challenging. We recommend using the MCP Inspector:

License

This project is licensed under the MIT License - see the LICENSE file for details.