io.github.yokingma/time-mcp MCP Server
io.github.yokingma/time-mcp
Give LLMs time awareness with timezone conversion, timestamps, and calendar utilities.
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.
{
"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 timerelative_time— Get relative timeget_timestamp— Get timestamp for the timedays_in_month— Get days in monthconvert_time— Convert time between timezonesget_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
It's an MCP server that gives LLMs time awareness capabilities, including current time retrieval, timezone conversion, timestamp generation, and calendar utilities.
Yes, it's open source under the MIT License.
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
Use Smithery: npx -y @smithery/cli install @yokingma/time-mcp --client claude, or manually add it to your Claude config.
No, it does not require any authentication or API keys.
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
<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 timeget_timestamp: Get timestamp for the timedays_in_month: Get days in monthconvert_time: Convert time between timezonesget_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.
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.

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

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

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

