MCP-timeserver

MCP.Pizza Chef: SecretiveShell

MCP-timeserver is a simple, efficient MCP server designed to expose current datetime information to agentic systems and chat REPLs. It implements a datetime:// URI scheme that allows querying the current date and time for various timezones worldwide, such as Africa/Freetown, Europe/London, and America/New_York. Additionally, it offers a tool to retrieve the current local time in the system's timezone programmatically. This server is ideal for applications requiring accurate, real-time temporal context integrated seamlessly into AI workflows and conversational agents. Installation is straightforward, enabling quick deployment within MCP environments.

Use This MCP server To

Provide real-time datetime context to AI agents Enable chatbots to access current time by timezone Integrate timezone-aware datetime queries in workflows Support scheduling and time-based decision making Expose system local time for logging or display Facilitate temporal reasoning in conversational AI

README

MCP-timeserver

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

Components

Resources

The server implements a simple datetime:// URI scheme for accessing the current date/time in a given timezone, for example:

datetime://Africa/Freetown/now
datetime://Europe/London/now
datetime://America/New_York/now

Tools

The server exposes a tool to get the current local time in the system timezone:

>>> get_current_time()
"The current time is 2024-12-18 19:59:36"

Quickstart

Install

use the following json

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

MCP-timeserver FAQ

How do I install MCP-timeserver?

Install MCP-timeserver by adding it to your MCP server configuration with the command 'uvx' and argument 'MCP-timeserver' as shown in the quickstart JSON snippet.

How does MCP-timeserver expose datetime information?

It uses a datetime:// URI scheme to provide current date and time for specified timezones, accessible by agentic systems and chat REPLs.

Can MCP-timeserver provide local system time?

Yes, it exposes a tool called get_current_time() that returns the current local time of the system running the server.

Is MCP-timeserver suitable for multi-timezone applications?

Absolutely, it supports querying current time in multiple timezones like Africa/Freetown, Europe/London, and America/New_York.

What environments can MCP-timeserver integrate with?

MCP-timeserver integrates with any MCP host or client that supports MCP servers, enabling real-time datetime context in AI workflows.

Does MCP-timeserver support daylight saving time adjustments?

Yes, the datetime information provided respects timezone rules including daylight saving time where applicable.

Can I use MCP-timeserver with OpenAI, Claude, or Gemini?

Yes, MCP-timeserver can feed datetime context to models from OpenAI, Anthropic Claude, and Google Gemini via MCP clients.

Is MCP-timeserver resource-intensive?

No, it is a lightweight server designed for efficient, real-time datetime queries without heavy resource consumption.