Log inSubmit server
MCP Time logo

MCP Time

Provides date and time tools over local stdio or remote Streamable HTTP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Time

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-time": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpcentral/mcp-time"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 6 tools correctly (Today).

Overview

mcp-time MCP server provides date and time tools through local stdio or a remote Streamable HTTP endpoint. It can return current times, relative time descriptions, month lengths, Unix timestamps, timezone conversions, and week numbers. Install the npm package for local clients or connect to the deployed Cloudflare Worker for remote access. Reach for it when an agent needs timezone-aware calculations or date formatting without implementing these operations itself.

Use cases

  • Check the current time in a named timezone
  • Convert timestamps between IANA timezones
  • Calculate the days in a month
  • Generate relative time descriptions
  • Retrieve ISO week numbers for dates

Key features

  • Current time by timezone and format
  • Relative time descriptions
  • Days-in-month calculation
  • Unix timestamp conversion
  • IANA timezone conversion
  • Week and ISO week lookup

Tools6

What MCP Time lets your agent do. Expand a tool for its parameters.

Verified live~546 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Read-only tools · 6
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age379 days
Maintainers1

Observed 2026-10-27 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 17d ago via OSV.dev · @mcpcentral/mcp-time (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads3.6kPackage downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.

How MCP Time works

What mcp-time does

The mcp-time MCP server exposes six date and time operations to MCP-compatible clients. It can retrieve the current date and time using a requested timezone and format, produce human-readable relative descriptions such as time remaining or elapsed time, and determine the number of days in a specified month and year.

The remaining tools handle common conversions and calendar values. get_timestamp converts a supplied time into a Unix timestamp in milliseconds. convert_time changes a time between IANA timezones. get_week_year returns the week number and ISO week number for a date.

These capabilities suit agents that need to answer timezone questions, normalize date values, perform basic calendar checks, or prepare timestamps for other operations.

How it works

The mcp-time MCP server supports two transports. In stdio mode, an MCP client launches the npm package locally and communicates with the process. The package can be installed globally with npm or run on demand with npx @mcpcentral/mcp-time.

In Streamable HTTP mode, a client connects to the deployed Cloudflare Worker at https://mcp.time.mcpcentral.io, or to another Worker deployment. The HTTP configuration uses the server URL and the streamable-http transport.

The project is implemented in TypeScript, with src/index.ts serving as the Cloudflare Worker entry point and containing the MCP logic. Local development can run the HTTP version through Wrangler on port 8787.

Setup and configuration

For local use, install the package globally or invoke it with npx. An MCP client configuration can launch the package with npx and the package name, or point to the installed executable. The README gives Claude Desktop as an example of a local stdio client.

For remote use, configure the client with the deployed URL and set the transport to Streamable HTTP. No environment variables are documented as required for the published local or remote connection examples.

Developers building from source can clone the repository, run npm install, and compile it with npm run build. Running npx wrangler dev starts a local HTTP endpoint. The project can be deployed to Cloudflare Workers with Wrangler after configuring the Worker deployment file, and the package can be published to npm after building it.

Tools and capabilities

The mcp-time MCP server provides these tools:

  • current_time: returns the current time for a specified timezone and format.
  • relative_time: creates a human-readable relative time string from a supplied time.
  • days_in_month: reports the number of days in a given month and year.
  • get_timestamp: converts a time into Unix milliseconds.
  • convert_time: converts a time between IANA timezones.
  • get_week_year: returns week and ISO week values for a date.

The repository includes command-line examples for initializing the stdio server and calling current_time. MCP Inspector, MCPCentral Lab, and MCPCentral Inspector are listed as options for testing the HTTP endpoint.

Limitations and notes

The mcp-time MCP server is limited to the six documented date and time operations. Remote deployments use Cloudflare Workers, while local stdio use requires Node.js tooling such as npm or npx.

The HTTP examples also show that Anthropic's MCP Connector and OpenAI's Agents SDK can connect to Streamable HTTP servers. Microsoft Copilot Studio support is described through a custom connector and its MCP tool configuration. These are connection options documented by the project rather than additional tools supplied by the server.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Time

mcp-time is an MCP server that connects AI clients to date and time functions through npm stdio or a Cloudflare Worker using Streamable HTTP. Its main tools return current times, relative time strings, month lengths, Unix timestamps, timezone conversions, and week or ISO week numbers.

Install it with npm globally or run it with npx: `npm install -g @mcpcentral/mcp-time` or `npx @mcpcentral/mcp-time`. Configure an MCP client to launch the package over stdio.

Set the MCP server URL to `https://mcp.time.mcpcentral.io` and select the `streamable-http` transport.

Yes, mcp-time works with Claude Desktop through its stdio transport. Configure Claude Desktop to run `npx @mcpcentral/mcp-time`, or provide the path to the globally installed executable.

The documented timezone operations use IANA timezone names, such as `America/New_York`, `Europe/London`, and `Asia/Tokyo`.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Time AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-time?style=directory)](https://allmcps.com/mcp/mcp-time)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-time"><img src="https://allmcps.com/api/badge/mcp-time?style=directory" alt="MCP Time on AllMCPs" /></a>