mcp-datetime
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:
- 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
- Install from GitHub Source
- Example
claude_desktop_config.json
for manual installationReplace "/path/to/your/python" with your actual Python interpreter pathe.g., "/usr/local/bin/python3" or "/Users/username/.pyenv/versions/3.12.0/bin/python3"
Basic Examples
- Command format
- Claude Desktop App prompt examples
- User
- Claude
- User
Supported Formats
Format Name | Example | Description |
---|---|---|
date | 2024-12-10 | Standard date format |
date_slash | 2024/12/10 | Date with slashes |
date_jp | 2024年12月10日 | Japanese date format |
datetime | 2024-12-10 00:54:01 | Standard datetime |
datetime_jp | 2024年12月10日 00時54分01秒 | Japanese datetime |
datetime_t | 2024-12-10T00:54:01 | DateTime with T separator |
compact | 20241210005401 | Compact format for IDs |
compact_date | 20241210 | Compact date only |
compact_time | 005401 | Compact time only |
filename_md | 20241210005401.md | Markdown filename |
filename_txt | 20241210005401.txt | Text filename |
filename_log | 20241210005401.log | Log filename |
iso | 2024-12-10T00:54:01+0900 | ISO 8601 format |
iso_basic | 20241210T005401+0900 | Basic ISO format |
log | 2024-12-10 00:54:01.123456 | Log format with microseconds |
log_compact | 20241210_005401 | Compact log format |
time | 00:54:01 | Time only |
time_jp | 00時54分01秒 | Japanese time format |
Debugging
Since MCP servers run over stdio, debugging can be challenging. We recommend using the MCP Inspector:
- Using PyPI package
- Using downloaded source code from GitHub
License
This project is licensed under the MIT License - see the LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
一个日期时间格式化服务,作为 Claude 桌面应用程序的 MCP 服务器实现。支持生成各种格式的日期时间字符串。
Related MCP Servers
- AsecurityAlicenseAqualityA Claude MCP server that allows Claude to interact with your FreeAgent account to track time, manage timers, and handle timeslip operations.Last updated -71MIT License
- AsecurityFlicenseAqualityA server built with mcp-framework that allows users to extend Claude's capabilities by adding custom tools that can be used through the Claude Desktop client.Last updated -3507
- AsecurityFlicenseAqualityAn MCP server that provides seamless integration with Claude Desktop for querying and managing timeseries data in GigAPI Timeseries Lake.Last updated -76