A
licenseB
qualityD
maintenanceGives large language models time awareness capabilities through various time-related functions including current time retrieval, timezone conversion, and relative time calculations.
Last updated
6
1,466
MIT
time-mcp
by yokingma
This server provides LLMs with comprehensive time awareness and manipulation capabilities:
Get current time - Retrieve current date and time in various formats (12/24-hour, different date formats) with optional timezone specification
Calculate relative time - Determine how much time has passed or will pass relative to a specific date/time (e.g., "2 hours ago", "in 3 days")
Convert timestamps - Generate Unix timestamps from date/time strings for precise time calculations
Get days in month - Find out how many days are in a specified month or the current month
Convert between timezones - Transform times from one IANA timezone to another (e.g., New York to Tokyo)
Get week numbers - Determine the week and ISO week numbers of the year for any given date
These tools enable LLMs to answer questions about current time, perform time calculations, handle timezone conversions, and work with various date/time formats.
Allows integration with Windsurf in Codeium, enabling time awareness capabilities for LLMs within the Codeium environment.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@time-mcpwhat time is it in Tokyo right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 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 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
Related MCP server: Time MCP Server
Installation
Installing via Smithery
To install time-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @yokingma/time-mcp --client claudeManually install (Optional)
npm install -g time-mcpusing npx
npx -y time-mcpRunning on Claude Code
To add time-mcp to Claude Code, use the following command:
claude mcp add time-mcp -- npx -y time-mcpTo verify the installation:
claude mcp listYou 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.
Maintenance
–Maintainers
–Response time
4moRelease cycle
2Releases (12mo)
Commit activity
Issues opened vs closed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides time and timezone functionality for LLMs, enabling them to get current time information across different timezones and convert times between zones.Last updated2MIT
- Flicense-qualityDmaintenanceEnables LLMs to get current time information for any timezone worldwide, including available regions, cities, and ISO 8601 formatted timestamps with timezone offsets.Last updated8
- AlicenseBqualityDmaintenanceProvides current time information and timezone conversion capabilities using IANA timezone names with automatic system detection. It enables LLMs to fetch local or global times and convert specific timestamps between different regions.Last updated22MIT
Related MCP Connectors
A real clock for AI agents: current time, timezone conversion, and DST facts from the IANA tzdb.
Wall-clock awareness for LLM agents. Two tools: elapsed-time-between-turns + day rollover detection.
A time server that keeps your AI honest about time. Real clock + drift guard, zero dependencies.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yokingma/time-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server