io.github.yokingma/time-mcp

@yokingma/time-mcp

Time MCP Server, giving LLMs time awareness capabilities.

66 6 tools GitHub npm

No known CVEs

No license

Maintained

Last commit 108d ago

Works with most clients

Transport: stdio, sse

6 tools · ~225 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-yokingma-time-mcp)](https://mcppedia.org/s/io-github-yokingma-time-mcp)

Read me

What io.github.yokingma/time-mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@yokingma/time-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

80/100across 5 weighted dimensions

How we score →

0255075100

−20

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @yokingma/time-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~225 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.yokingma/time-mcp safe to use?: io.github.yokingma/time-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.yokingma/time-mcp?: io.github.yokingma/time-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.yokingma/time-mcp do?: io.github.yokingma/time-mcp provides 6 tools: current_time, relative_time, get_timestamp, days_in_month, convert_time and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.yokingma/time-mcp?: io.github.yokingma/time-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.
Is io.github.yokingma/time-mcp actively maintained?: io.github.yokingma/time-mcp is less actively maintained — last commit was 108 days ago. It has 66 GitHub stars.

Similar servers

Others in productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

104 7

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

238 1

Obsidian Local Llm Hub93

All-in-one local AI hub for Obsidian — LLM chat with vault tools, MCP servers, RAG, workflow automation, encryption, and edit history. Fully private, no cloud required.

40 11

MCP Security Weekly

Get CVE alerts and security updates for io.github.yokingma/time-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

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.

Frequently Asked Questions

Is io.github.yokingma/time-mcp safe to use?

io.github.yokingma/time-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.yokingma/time-mcp?

io.github.yokingma/time-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.yokingma/time-mcp do?

io.github.yokingma/time-mcp provides 6 tools: current_time, relative_time, get_timestamp, days_in_month, convert_time and 1 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.yokingma/time-mcp?

io.github.yokingma/time-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse transport.

Is io.github.yokingma/time-mcp actively maintained?

io.github.yokingma/time-mcp is less actively maintained — last commit was 108 days ago. It has 66 GitHub stars.

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

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:

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.