MCP-timeserver

A simple MCP server that exposes datetime information to agentic systems and chat REPLs

python

42

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks 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": {
    "secretiveshell-mcp-timeserver": {
      "command": "uvx",
      "args": [
        "MCP-timeserver"
      ]
    }
  }
}

You can run a small MCP server that exposes current date and time through a simple datetime:// URI scheme and a local time tool. This enables agentic systems and chat REPLs to query time information in various timezones in a standardized way.

How to use

Interact with the MCP-timeserver by using datetime:// URIs to fetch the current date and time for a specific timezone. Examples include datetime://Africa/Freetown/now, datetime://Europe/London/now, and datetime://America/New_York/now. You can also utilize the local time tool to retrieve the system’s current time in its timezone.

The server provides a small Python example of the local time tool to illustrate what the endpoint returns. You can call the tool in your environment to quickly verify the current time, for instance calling get_current_time() yields a string like "The current time is 2024-12-18 19:59:36".

How to install

{
  "mcpServers": {
    "MCP-timeserver": {
      "command": "uvx",
      "args": ["MCP-timeserver"]
    }
  }
}

Additional notes

The MCP-timeserver exposes a simple datetime URI scheme for accessing the current date/time in a given timezone, enabling straightforward integration with agents and chat interfaces that rely on standardized time data.

Available tools

get_current_time

Returns the current local time in the system timezone as a string, demonstrating how the server can expose time information to MCP clients.

datetime_uri_scheme

Defining a simple datetime:// URI scheme to fetch the current date/time for a specified timezone, enabling integration with agentic systems and chat REPLs.