DateTime

Provides current date/time in multiple formats with timezone and custom formatting options.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "takanarishimbo-uvx-datetime-mcp-server": {
      "command": "uvx",
      "args": [
        "takanarishimbo-datetime-mcp-server"
      ],
      "env": {
        "TIMEZONE": "UTC",
        "DATETIME_FORMAT": "iso",
        "DATE_FORMAT_STRING": "%Y-%m-%d %H:%M:%S"
      }
    }
  }
}

The DateTime MCP Server provides a simple way to obtain the current date and time in multiple formats, with timezone and custom formatting options. This makes it easy to power applications that need consistent timestamps across different regions and display formats.

How to use

You access the current date and time through an MCP client by connecting to a datetime MCP server. You can request different output formats such as ISO, Unix timestamps, human-friendly strings, or a custom format. Timezone handling lets you align timestamps with the user’s locale, and a single tool named get_current_time exposes the core functionality.

How to install

Prerequisites: you need the MCP runtime environment available on your machine. The server is designed to run via the MCP runtime tool and is implemented in Python, with the usage shown using the uvx command runner.

Clone the project repository to your workspace.
Install dependencies using the MCP runtime tooling.
Start the datetime MCP server using the runtime command.

Configuration and usage notes

Default output is ISO format unless you override it with environment variables. You can customize the format, timezone, and date-time string by setting environment variables as shown below.

Environment variables you may use include: DATETIME_FORMAT to select the output format, TIMEZONE to set the timezone, and DATE_FORMAT_STRING for a custom strftime pattern when using the custom format.

Examples you can try after starting the server

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

More configuration options

Human-readable output with a specific timezone, Unix timestamp, and a custom format example are provided in dedicated configurations. You can set DATETIME_FORMAT to human, unix, or custom and supply TIMEZONE and DATE_FORMAT_STRING accordingly.

Troubleshooting and tips

If you encounter issues starting the server, verify that the MCP runtime is installed, the server's runtime command is accessible as shown, and the environment variables are correctly set in the running process. Check that the server name in your MCP client matches the configured server key (datetime).

Security and maintenance notes

Keep the runtime and dependencies up to date. Use isolated environments for testing custom configurations and avoid exposing internal endpoints publicly without proper access controls.

Available tools

get_current_time

Get the current date and time in the requested format and timezone; supports optional format and timezone overrides