PluginBench
MCP Server
Stale
MIT

io.github.yokingma/time-mcp MCP Server

io.github.yokingma/time-mcp

Give LLMs time awareness with timezone conversion, timestamps, and calendar utilities.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Hand your agent a structured way to call a model or an inference API.
  • Compare outputs from two different providers on the same prompt.
  • Wire retrieval, embeddings, or generation into an existing agent workflow.

How to compare servers like this

Provider coverage:
Match the tool's supported providers and models to the ones your project uses.
Cost exposure:
Model-backed tools spend real API budget; check how usage and limits are configured.
Maintenance signal:
The provider landscape shifts weekly; prefer tools updated within the last few months.
Config surface:
Prefer tools whose environment-variable or config keys are documented plainly.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the io.github.yokingma/time-mcp MCP server?

The Time MCP Server is a Model Context Protocol server that provides LLMs with time awareness capabilities including current time retrieval, timezone conversion, and calendar information. It exposes tools for getting timestamps, calculating relative time, and querying week/month data.

This server enables AI assistants to understand and work with time-related information accurately. It's useful when you need Claude or other LLMs to answer questions about current time, convert between timezones, calculate dates, or provide time-aware context in conversations.

How to install io.github.yokingma/time-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "time-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "time-mcp"
      ]
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • current_time — Get current time in 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

Use cases

  • Ask Claude what time it is now in multiple timezones
  • Convert meeting times between different time zones (e.g., 2:00 PM New York to Tokyo)
  • Determine how many days are in a specific month for scheduling
  • Find what week of the year a given date falls on
  • Get Unix timestamps for time-based calculations or logging

io.github.yokingma/time-mcp MCP server FAQ

What is the Time MCP Server?

It's an MCP server that gives LLMs time awareness capabilities, including current time retrieval, timezone conversion, timestamp generation, and calendar utilities.

Is it free?

Yes, it's open source under the MIT License.

How do I install it in Cursor?

Add it to your mcp.json file with the command 'npx' and args ['-y', 'time-mcp'], or use the Smithery CLI: npx -y @smithery/cli install @yokingma/time-mcp --client claude

How do I install it in Claude Desktop?

Use Smithery: npx -y @smithery/cli install @yokingma/time-mcp --client claude, or manually add it to your Claude config.

Does it require authentication?

No, it does not require any authentication or API keys.

What timezone conversions does it support?

The server can convert time between any timezones; specific timezone support depends on Node.js's built-in timezone database.

README (reference)

Source of truth, from the repository.

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

smithery badge <a href="https://github.com/yokingma/time-mcp/stargazers"><img src="https://img.shields.io/github/stars/yokingma/time-mcp" alt="Github Stars"></a> <a href="https://github.com/yokingma/time-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-purple" alt="License"></a> <a href="https://github.com/yokingma/time-mcp/issues/new"><img src="https://img.shields.io/badge/Report a bug-Github-%231F80C0" alt="Report a bug"></a>

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

<div align="center"> <img src="./assets/cursor.png"></img> </div>

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:

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

Manually install (Optional)

npm install -g time-mcp

using npx

npx -y time-mcp

Running on Claude Code

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

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

To verify the installation:

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:

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

Running on Windsurf

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

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

License

MIT License - see LICENSE file for details.

Related MCP servers

Web search, URL discovery, scraping & content extraction with multiple search providers and local browser automation.

138
TypeScript
MIT
View repository →

MCP server providing personalized greetings with AI-powered tools using Spring Boot and Spring AI

Generate and edit images with GPT Image 2.5 for $0.029 — free key, 50 credits, no card.

0
TypeScript
MIT
View repository →

Local Bazi charts, Ten Gods and true solar time, with structured facts and PNG images.

2
TypeScript
MIT
View repository →
YOYolfi Payments MCP logo

AI agent crypto payment integration for checkout, paylinks, webhooks, and status checks.

219
JavaScript
MIT
View repository →

Safety-first WhatsApp tools: draft-gated sends, enforced rate limits, append-only audit.

0
Go
Apache-2.0
View repository →