datetime formatter.com
datetime formatter.com logo

Datetime Formatter

Provides flexible, timezone-aware date and time formatting across various locales.

Created byApr 23, 2025

mcp-datetime

[![Python Version](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/) [![MCP Version](https://img.shields.io/badge/mcp-1.1.1-green.svg)](https://github.com/anaisbetts/mcp) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
English | [ ](README_ja.md)
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:
  • Python 3.12 or later
  • uv (Python package installer)
  • uvx (Python package runner)

Features

  • Support for various datetime formats
  • Japanese language support
  • Optimized formats for filename generation
  • Accurate timezone handling
  • Seamless integration with Claude Desktop App

MCP Server Components

Tools

The server implements one tool:
  • `get_datetime`: Get current date and time in various formats - Takes "format" as a required string argument - Returns formatted datetime string based on specified format - Supports multiple format types including standard, Japanese, and ISO formats

Usage with Claude Desktop App

Add the following to your config file:
Config file location (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`

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:
  • Install from PyPI ```bash pip install mcp-datetime ```
  • Install from GitHub Source ```bash git clone https://github.com/ZeparHyfar/mcp-datetime.git cd mcp-datetime pip install -e . ```
  • Example `claude_desktop_config.json` for manual installation ```json { "mcpServers": { "mcp-datetime": { "command": "python", "args": ["-m", "mcp_datetime"], "env": { "PYTHON": "/path/to/your/python" } } } } ``` Replace "/path/to/your/python" with your actual Python interpreter path > e.g., "/usr/local/bin/python3" or "/Users/username/.pyenv/versions/3.12.0/bin/python3"

Basic Examples

  • Command format ``` # Standard datetime format call datetime-service.get_datetime {"format": "datetime"} # Result: 2024-12-10 00:54:01 # Japanese format call datetime-service.get_datetime {"format": "datetime_jp"} # Result: 2024 12 10 00 54 01 # Filename format call datetime-service.get_datetime {"format": "filename_md"} # Result: 20241210005401.md ```
  • Claude Desktop App prompt examples - User ``` Please tell me the current time in date_slash format ``` - Claude ``` I'll get the current date in date_slash format. The current date is 2024/12/12 ```

Supported Formats

[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Debugging

Since MCP servers run over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):
  • Using PyPI package ``` npx @modelcontextprotocol/inspector uvx mcp-datetime ```
  • Using downloaded source code from GitHub ``` git clone https://github.com/ZeparHyfar/mcp-datetime.git npx @modelcontextprotocol/inspector uvx --directory ./mcp-datetime run mcp-datetime ```

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.