mcp-datetime

A TypeScript implementation of a Model Context Protocol (MCP) server that provides datetime and timezone information to agentic systems and chat REPLs.

MCP DateTime is a simple server that implements the Model Context Protocol to provide datetime and timezone information to AI agents and chat interfaces. It allows AI systems to:

• Get the current time in the local system timezone
• Get the current time in any valid timezone
• List all available timezones
• Access timezone information through URI resources

npm install -g mcp-datetime

git clone https://github.com/odgrmi/mcp-datetime.git
cd mcp-datetime
npm install
npm run build

MCP DateTime can be run in two modes:

This mode is ideal for integrating with AI systems that support the MCP protocol through standard input/output:

mcp-datetime

This mode starts an HTTP server that provides SSE transport for the MCP protocol:

mcp-datetime --sse

You can also specify a custom port and URI prefix:

mcp-datetime --sse --port=8080 --prefix=/api/datetime

• PORT: Sets the port for SSE mode (default: 3000)
• URI_PREFIX: Sets the URI prefix for SSE mode (default: none)

MCP DateTime provides the following tools:

Returns the current time in the system's local timezone.

Returns the current system timezone.

Returns the current time in a specified timezone.

Parameters:

• timezone: The timezone to get the current time for (e.g., "America/New_York")

Returns a list of all available timezones.

MCP DateTime also provides access to timezone information through resource URIs