Skip to main content
Glama

mcp-datetime

by ZeparHyfar

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:

  • 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

{ "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

    pip install mcp-datetime
  • Install from GitHub Source

    git clone https://github.com/ZeparHyfar/mcp-datetime.git cd mcp-datetime pip install -e .
  • Example claude_desktop_config.json for manual installation

    { "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.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

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

  1. Prerequisites
    1. Features
      1. MCP Server Components
        1. Tools
      2. Usage with Claude Desktop App
        1. About Installation
          1. Basic Examples
            1. Supported Formats
              1. Debugging
                1. License

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Claude MCP server that allows Claude to interact with your FreeAgent account to track time, manage timers, and handle timeslip operations.
                    Last updated -
                    1
                    MIT License
                    • Linux
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Claude Model Configuration Protocol (MCP) server that provides real-time timezone-aware date and time information.
                    Last updated -
                  • A
                    security
                    F
                    license
                    A
                    quality
                    An MCP server that provides seamless integration with Claude Desktop for querying and managing timeseries data in GigAPI Timeseries Lake.
                    Last updated -
                    7
                    6
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A simple MCP server that provides accurate date and time information to Claude models, ensuring they always use the correct current date and time when creating time-sensitive content.
                    Last updated -
                    3
                    • Apple

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZeparHyfar/mcp-datetime'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server