Time Server
About
Time Server is an MCP (Model Context Protocol) server that provides timezone conversions and time-related operations. It is built with MCP protocol standards and offers tools to get current time in any timezone and convert time between timezones. It targets developers and AI…
Details
- Author
- MCP-Mirror
- Downloads
- 288
- Categories
- Productivity
Jump to
- Get current time in any timezone
- Convert time between timezones
- Built with MCP protocol standards
- Type-safe Python implementation
- Comprehensive error handling
- Timezone database integration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Time ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Smithery (npx -y @smithery/cli install @clssck/mcp-time-server --client claude) or manually (pip install .). Start the server with python -m time_server. The server exposes two tools: get_current_time and convert_time, each accepting IANA timezone identifiers.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"time server": {
"clssck_mcp-time-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@clssck/mcp-time-server",
"--client",
"claude"
]
}
}
}
}McpServers
{
"clssck_mcp-time-server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@clssck/mcp-time-server",
"--client",
"claude"
]
}
}Time Server
An MCP server for timezone conversions and time-related operations, built with the Model Context Protocol standards.
Table of Contents
- Features
- Installation
- Usage
- API Documentation
- Development
- Contributing
- Code of Conduct
- License
Features
- Get current time in any timezone
- Convert time between timezones
- Built with MCP protocol standards
- Type-safe Python implementation
- RESTful API endpoints
- Comprehensive error handling
- Timezone database integration
Installation
Installing via Smithery
To install Time Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @clssck/mcp-time-server --client claude
Manual Installation
pip install .
Usage
Start the server:
python -m time_server
API Documentation
Tools
get_current_time
Get current time in a specific timezone
Parameters:
- timezone: string - IANA timezone identifier (e.g. "America/New_York")
Returns:
- Current time in ISO 8601 format
convert_time
Convert time between timezones
Parameters:
- time: string - Time to convert in ISO 8601 format
- from_timezone: string - Source timezone
- to_timezone: string - Target timezone
Returns:
- Converted time in ISO 8601 format
Development
Install development dependencies:
pip install -e .[dev]
Run tests:
pytest
Check code quality:
ruff check .
mypy src
Code of Conduct
This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code.
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
