Log inSubmit server
Time MCP logo

Time MCP

Adds MCP tools for current time, timestamps, date calculations, relative time, week numbers, and timezone conversion.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Time MCP

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": {
    "time-mcp-2": {
      "command": "npx",
      "args": [
        "-y",
        "time-mcp"
      ]
    }
  }
}

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

time-mcp MCP server gives language models tools for querying current time, calculating relative time, generating timestamps, and handling calendar and timezone operations. It runs through a local npm or npx command and exposes six MCP tools to connected clients. Reach for it when an agent needs explicit time awareness, date arithmetic, week-year information, or timezone conversion.

Use cases

  • Check the current UTC and local time
  • Convert a scheduled time between timezones
  • Calculate relative time
  • Find the number of days in a month
  • Look up the week and ISO week of a year

Key features

  • Current UTC and local time lookup
  • Relative-time calculation
  • Timestamp generation
  • Days-in-month lookup
  • Timezone conversion
  • Week and ISO week lookup

Tools6

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

Verified live~497 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 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 46d

What it can do

From the 6 tools this server returned when we ran it.

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

Observed 2026-10-24 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 6d ago via OSV.dev · time-mcp (npm)

Adoption & maintenance

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

GitHub stars72Stargazers on the source repository.
npm downloads7.8kPackage downloads in the last 30 days.
Last commit8mo 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.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Time MCP works

What time-mcp MCP server does

time-mcp MCP server exposes time and calendar operations through the Model Context Protocol. It is intended for language-model clients that need to answer time-sensitive questions or perform date-related calculations through structured tools rather than relying only on the model's built-in knowledge.

The server covers both direct lookups and transformations. It can report current UTC and local time, calculate relative time, produce timestamps, determine the number of days in a month, convert values between timezones, and return week and ISO week information for a year.

How it works

The project runs as a local MCP process started with npm or npx. An MCP-compatible client launches the command and makes the registered tools available to the model.

Its six tools divide the functionality into focused operations:

  • current_time returns current UTC and local time.
  • relative_time provides relative-time calculations.
  • get_timestamp gets a timestamp for a time.
  • days_in_month reports the number of days in a month.
  • convert_time converts time between timezones.
  • get_week_year returns week and ISO week values for the year.

This makes the server suitable for prompts such as asking for the current time, converting a time from New York to Tokyo, checking the length of the current month, or finding the current week of the year.

Setup and configuration

The package can be installed globally with npm:

Terminal
npm install -g time-mcp

Alternatively, clients can launch it without a global installation:

Terminal
npx -y time-mcp

For Claude Desktop, the README provides an automated Smithery installation command:

Terminal
npx -y @smithery/cli install @yokingma/time-mcp --client claude

Claude Code can register the server with:

Terminal
claude mcp add time-mcp -- npx -y time-mcp

A connected entry should appear with a connected status.

Cursor and Windsurf use an MCP server entry that runs npx with -y and time-mcp as its argument. Cursor places this configuration in mcp.json; Windsurf uses ./codeium/windsurf/model_config.json.

Tools and capabilities

The time-mcp MCP server is focused on time awareness rather than general-purpose data access. Its capabilities include local and UTC current-time reporting, relative-time handling, timestamp generation, month-length lookup, timezone conversion, and week-number lookup. No other tools or integrations are listed in the provided project material.

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 Time MCP

time-mcp is an MCP server that connects language-model clients to time and calendar tools. Its main tools retrieve current UTC and local time, calculate relative time, generate timestamps, count days in a month, convert between timezones, and return week and ISO week values.

Install it globally with `npm install -g time-mcp`, or run it directly with `npx -y time-mcp`. The README also provides a Smithery command for automated Claude Desktop installation.

Yes, time-mcp works with Claude Code through `claude mcp add time-mcp -- npx -y time-mcp`. Run `claude mcp list` afterward to check that the server appears as connected.

Add a `time-mcp` entry to Cursor's `mcp.json` that runs `npx` with `-y` and `time-mcp` as arguments. The README provides the complete command-and-args structure.

Yes, the `convert_time` tool converts a time between timezones. The README gives converting 2:00 PM from New York to Tokyo as an example use.

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 PreviewTime MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/time-mcp-2?style=directory)](https://allmcps.com/mcp/time-mcp-2)
HTML Embed
<a href="https://allmcps.com/mcp/time-mcp-2"><img src="https://allmcps.com/api/badge/time-mcp-2?style=directory" alt="Time MCP on AllMCPs" /></a>