mcp-datetime

Datetime formatting service MCP server for Claude Desktop App

Stars

Forks

Watchers

Issues

mcp-datetime provides a datetime formatting service implemented as an MCP server for integration with the Claude Desktop Application. It offers generation of current date and time strings in various formats, including standard, Japanese, ISO, and filename-friendly outputs. The server exposes a 'get_datetime' tool for easy retrieval of formatted dates and times with support for timezone handling and multi-language output. Seamless integration and Python packaging facilitate installation and extensibility.

Key Features

Implements the Model Context Protocol (MCP) server specification

Supports various datetime formats including standard, Japanese, and ISO

Offers a single tool 'get_datetime' for date and time retrieval

Seamless integration with Claude Desktop Application

Timezone handling for accurate time outputs

Optimized output formats for filename generation

Multilingual support, including Japanese

Installation via PyPI or GitHub source

macOS tested (Windows compatibility unverified)

JSON-based configuration for desktop integration

Use Cases

Generating current datetime strings for note-taking in the Claude Desktop App

Auto-creating filenames with timestamps for file organization

Providing Japanese-localized date and time formats for region-specific workflows

Inputting formatted dates and times into user prompts for digital assistants

Handling timezone-aware scheduling within integrated desktop applications

Generating compact IDs based on current timestamps

Producing ISO-formatted datetimes for API consumption or logging

Customizing desktop automation workflows needing dynamic date and time values

Testing or developing time-aware plugins for desktop productivity tools

Enhancing multilingual desktop environments with locale-specific datetime outputs

README

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

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:

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

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

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 file for details.

Star History

Repository Owner

ZeparHyfar

User

Repository Details

Language Python

Default Branch main

Size 22 KB

Contributors 1

License MIT License

MCP Verified Nov 12, 2025

Programming Languages

Python

100%

Related MCPs

Discover similar Model Context Protocol servers

MCP Manager for Claude Desktop

A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.

MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.

⭐ 270
MCP
zueai/mcp-manager

Time Node MCP Server

Timezone-aware date and time operations for AI assistants and applications.

Time Node MCP Server is an implementation of the Model Context Protocol (MCP) designed to provide accurate, timezone-aware date and time operations. It exposes tools for retrieving and converting times across IANA timezones, detecting system timezone, and offering outputs in multiple formats. The server ensures correct handling of Daylight Saving Time transitions and supports integration with AI assistants like Claude Desktop.

⭐ 0
MCP
davidan90/time-node-mcp

mcp-time

A Model Context Protocol server for time and date operations

mcp-time is a Model Context Protocol (MCP) server that enables AI assistants and MCP clients to perform standardized time and date-related operations. It provides natural language parsing for relative time expressions, supports flexible formatting, and allows manipulation and comparison of times. The server offers multiple integration methods, including stdio, HTTP stream, Docker, and npx for compatibility with various clients. It is designed for robust time handling and easy integration with AI tools.

⭐ 8
MCP
TheoBrigitte/mcp-time

MCP-timeserver

A simple MCP server providing date and time information to agentic systems.

MCP-timeserver exposes current datetime information via a custom datetime URI scheme compatible with the Model Context Protocol. It allows agentic systems and chat REPLs to access timezone-aware current times and offers a tool to fetch the system's local time. The server is designed to integrate with MCP-based workflows by providing standardized datetime resources.

⭐ 39
MCP
SecretiveShell/MCP-timeserver

MCP Simple Timeserver

Provides local and UTC time to AI models via the Model Context Protocol.

MCP Simple Timeserver provides current local time, timezone, and UTC information to AI models such as Claude by serving as a Model Context Protocol (MCP) tool. It offers two main endpoints: one for retrieving the user's local time and timezone, and another for fetching the current UTC time from an NTP server. The project supports both local and web server deployments and can be integrated into the Claude desktop app to enhance temporal awareness for LLMs.

⭐ 25
MCP
andybrandt/mcp-simple-timeserver

MCP Server for Data Exploration

Interactive Data Exploration and Analysis via Model Context Protocol

MCP Server for Data Exploration enables users to interactively explore and analyze complex datasets using prompt templates and tools within the Model Context Protocol ecosystem. Designed as a personal Data Scientist assistant, it facilitates the conversion of raw data into actionable insights without manual intervention. Users can load CSV datasets, run Python scripts, and generate tailored reports and visualizations through an AI-powered interface. The server integrates directly with Claude Desktop, supporting rapid setup and seamless usage for both macOS and Windows.

⭐ 503
MCP
reading-plus-ai/mcp-server-data-exploration

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

mcp-datetime

Key Features

Use Cases

README

mcp-datetime

Prerequisites

Features

MCP Server Components

Tools

Usage with Claude Desktop App

About Installation

Basic Examples

Supported Formats

Debugging

License

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Related MCPs