Time Mcp

io.github.yokingmaPublished by GitHub account yokingmav1.0.6Updated Oct 24, 2026

Time MCP Server, giving LLMs time awareness capabilities.

VerifiedSTDIODesktop onlyProductivity & Workflow

Overview

AI-generated overview

A local MCP server that gives an AI assistant time awareness: current time, timestamps, timezone conversion, and calendar calculations.

What you can do
Get the current time in UTC and local time, plus timestamps for a given time and relative time offsets. Convert times between timezones. Calculate calendar details such as days in a month and the week and ISO week of the year.
When to use it
Useful when an assistant needs reliable clock and calendar facts rather than guessing, for example answering what time it is, converting a meeting time across timezones, or working out week numbers and month lengths.
Requirements
Runs as a local process via npm package time-mcp, started with npx or installed globally; requires Node.js and npm. No accounts, API keys, or environment variables are declared.
Before you install
Read-only time and calendar lookups; no data is written or sent to third parties according to the provided material. Timezone results depend on the local machine's timezone data.

Installation

In SourceWeft

  1. Open Time Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

[smithery badge] [Github Stars] [License] [Report a bug]

A Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.

Tools

  • current_time: Get current time (UTC and local time)
  • relative_time: Get relative time
  • get_timestamp: Get timestamp for the time
  • days_in_month: Get days in month
  • convert_time: Convert time between timezones
  • get_week_year: Get week and isoWeek of the year

Installation

Installing via Smithery

To install time-mcp for Claude Desktop automatically via Smithery:

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

Manually install (Optional)

shell
npm install -g time-mcp

using npx

shell
npx -y time-mcp

Running on Claude Code

To add time-mcp to Claude Code, use the following command:

bash
claude mcp add time-mcp -- npx -y time-mcp

To verify the installation:

bash
claude mcp list

You should see time-mcp listed with a ✓ Connected status.

Usage in Claude Code

Once installed, you can use time-mcp tools in your conversations with Claude Code. For example:

  • "What time is it now?"
  • "Convert 2:00 PM from New York to Tokyo time"
  • "How many days are in this month?"
  • "What week of the year is it?"

The time-mcp server will automatically provide accurate time information to Claude.

Running on Cursor

Your mcp.json file will look like this:

json
{  "mcpServers": {    "time-mcp": {      "command": "npx",      "args": ["-y", "time-mcp"]    }  }}

Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json file:

json
{  "mcpServers": {    "time-mcp": {      "command": "npx",      "args": ["-y", "time-mcp"]    }  }}

License

MIT License - see LICENSE file for details.

Source: README.md at commit 5bc003e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.6LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts