Time Server
Simple MCP to give Claude ability to check current time as well as know when holidays are, what is the time distance between dates etc.
What is Time Server?
Time Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to simple mcp to give claude ability to check current time as well as know when holidays are, what is the time distance between dates etc.
Simple MCP to give Claude ability to check current time as well as know when holidays are, what is the time distance between dates etc.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Simple MCP to give Claude ability to check current time as w
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-simple-timeserverManual Installation
npx -y mcp-simple-timeserverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Time Server
MCP Simple Timeserver gives Claude and other AI assistants a reliable sense of time by exposing six dedicated time tools: current local time, accurate UTC via NTP, timezone-aware time queries, date distance calculations with optional business-day and holiday exclusion, holiday lookups for approximately 119 countries, and holiday checks for specific dates. Without this server, LLMs have no access to the current time or calendar context; with it, they can answer date-sensitive questions, build countdowns, and schedule-aware workflows accurately.
Prerequisites
- Python 3.8 or higher installed
- pip package manager available
- An MCP-compatible client such as Claude Desktop
- Network access for NTP time synchronization (get_utc tool)
Install via pip
Install the mcp-simple-timeserver package from PyPI. This is the recommended standalone installation method.
pip install mcp-simple-timeserverOr install via Smithery
Alternatively, use the Smithery CLI to install and auto-configure the server for Claude Desktop in one step.
npx -y @smithery/cli install mcp-simple-timeserver --client claudeConfigure Claude Desktop (macOS/Linux)
Add the timeserver to your Claude Desktop config. The server runs as a Python module with no API keys or environment variables required.
{
"mcpServers": {
"simple-timeserver": {
"command": "python",
"args": ["-m", "mcp_simple_timeserver"]
}
}
}Configure Claude Desktop (Windows)
On Windows, use the full path to the Python executable found via 'where python'.
{
"mcpServers": {
"simple-timeserver": {
"command": "C:\\Users\\YourName\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": ["-m", "mcp_simple_timeserver"]
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop. Ask 'What time is it right now?' to confirm the server is responding with live time data.
Time Server Examples
Client configuration
Minimal Claude Desktop configuration for mcp-simple-timeserver on macOS or Linux. No API keys needed.
{
"mcpServers": {
"simple-timeserver": {
"command": "python",
"args": ["-m", "mcp_simple_timeserver"]
}
}
}Prompts to try
Time and calendar queries Claude can answer accurately with the timeserver connected.
- "What is the current time in Tokyo?"
- "How many days until December 31st?"
- "How many business days are left in this month, excluding public holidays in Germany?"
- "Is January 19th, 2026 a public holiday in Poland?"
- "What public holidays does Japan have in 2026?"
- "What time is it right now in UTC?"Troubleshooting Time Server
Python module not found: No module named mcp_simple_timeserver
The package may have been installed in a different Python environment than the one Claude Desktop launches. Run 'pip show mcp-simple-timeserver' to find the install location, then use the full path to that Python interpreter in your config, e.g. /usr/local/bin/python3.
get_utc returns stale or incorrect time
The get_utc tool syncs with an NTP server and requires outbound UDP access on port 123. Check that your firewall allows NTP traffic. If behind a strict corporate firewall, use get_local_time instead, which reads from the system clock.
Holiday data missing for a specific country or region
The server covers approximately 119 countries. Check the GitHub repository for the supported country list. For sub-national holidays (e.g., US state or German federal state holidays), pass the city parameter to get_holidays or is_holiday for more granular results.
Frequently Asked Questions about Time Server
What is Time Server?
Time Server is a Model Context Protocol (MCP) server that simple mcp to give claude ability to check current time as well as know when holidays are, what is the time distance between dates etc. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Time Server?
Install via npm with the command: npx -y mcp-simple-timeserver. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Time Server?
Time Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Time Server free to use?
Yes, Time Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Time Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to Time Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Time Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Time Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.