Time Server

Time Server

An MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.

clssck

OS Automation
Visit Server

README

Time Server

smithery badge MCP Python License

An MCP server for timezone conversions and time-related operations, built with the Model Context Protocol standards.

Table of Contents

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

Recommended Servers

@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.

Featured
Local
JavaScript
Claude Code MCP

Claude Code MCP

An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.

Featured
Local
JavaScript
ThingsPanel MCP

ThingsPanel MCP

An integration server that connects AI models with ThingsPanel IoT platform, allowing AI assistants to interact with IoT devices through natural language for device control, data retrieval, and management operations.

Official
Python
Beamlit MCP Server

Beamlit MCP Server

An MCP server implementation that enables seamless integration between Beamlit CLI and AI models using the Model Context Protocol standard.

Official
TypeScript
Xcode MCP Server

Xcode MCP Server

Bridges Claude AI with Xcode, enabling AI-powered code assistance, project management, and automated development tasks securely on your local machine.

Local
TypeScript
mcp-screenshot

mcp-screenshot

Provides screenshot and OCR capabilities for macOS.

Local
JavaScript
macOS Defaults MCP Server

macOS Defaults MCP Server

MCP server that enables reading and writing macOS system preferences and application settings through the defaults system.

Local
Python
Shell MCP Server

Shell MCP Server

A Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.

Local
Python
MCP Command Server

MCP Command Server

A secure server that allows LLM applications like Claude to execute whitelisted system commands with user confirmation and comprehensive security features.

Local
Python
iTerm MCP Server

iTerm MCP Server

This MCP server enables users to execute shell commands in the current iTerm2 session through integration with Claude Desktop, facilitating seamless command execution via the Model Context Protocol.

Local
TypeScript