TheoBrigitte/mcp-time

*A Model Context Protocol server that enables AI assistants to interact with time*
Hosted deployment
A hosted deployment is available on Fronteir AI.
Overview
The Time MCP Server is a Model Context Protocol (MCP) server that provides AI assistants and other MCP clients with standardized tools to perform time and date-related operations. This server acts as a bridge between AI tools and a robust time-handling backend, allowing for complex time manipulations through natural language interactions.
Features
- **⏰ Time Manipulation** - Get current time, convert between timezones, and add or subtract durations
- **🗣️ Natural Language Parsing** - Understands relative time expressions like "yesterday" or "next month"
- **⚖️ Time Comparison** - Compare two different times with ease
- **🎨 Flexible Formatting** - Supports a wide variety of predefined and custom time formats
- **✅ MCP Compliance** - Fully compatible with the Model Context Protocol standard
- **🔄 Multiple Transports** - Supports stdio for local integrations and HTTP stream for network access
Installation
This MCP server can be integrated with various AI assistant clients that support the Model Context Protocol, including Cursor, Claude Desktop, Claude Code, and many more.
🚀 One-Click Install (Cursor)
Click the button below to automatically configure the MCP server using Docker in your Cursor environment:
Using npx (JavaScript/Node.js)
This method runs the MCP server using npx, which requires Node.js to be installed. Copy the following JSON configuration into your MCP client settings:
Using Docker
Run the MCP server in an isolated container. Requires Docker to be installed. Copy this JSON configuration into your MCP client settings:
Using binary
Install the mcp-time binary directly on your system. Choose one of the installation methods below, ensuring the binary is placed in a directory that's in your PATH. Then add this JSON configuration to your MCP client settings:
Option 1: Download from Releases
Download the latest pre-built binary from the releases page:
Option 2: Install with Go
For Go developers, install directly using go install:
The binary will be installed in your $GOPATH/bin directory.
Option 3: Build from Source
Clone and build the project using make:
The binary will be installed in ~/.local/bin/mcp-time.
Usage
Basic Usage
**Start with stdio transport** (default, for MCP clients):
**Start with HTTP stream transport** (for network access):
Command-Line Options
The server supports the following flags for advanced configurations:
Available Tools
current_time
Get the current time in any timezone and format.
**Parameters:**
- format (optional) - The output format (predefined like RFC3339, Kitchen, or custom Go layout)
- timezone (optional) - Target timezone in IANA format (e.g., America/New_York). Defaults to UTC
**Example:** "What time is it in Tokyo?"
relative_time
Get a time based on a relative natural language expression.
**Parameters:**
- text (required) - Natural language expression (e.g., yesterday, 5 minutes ago, next month)