Time

What is Time?

Time is a Model Context Protocol (MCP) server that provides AI assistants with standardized tools for time and date operations. It acts as a bridge between AI tools and a robust time-handling backend, enabling natural language interactions for time manipulation.

How to use Time?

Install the server using Docker (docker run --rm -i theo01/mcp-time:latest), download the binary from releases, or build from source. Run it with mcp-time for stdio transport, or mcp-time --transport stream --address "http://localhost:8080/mcp" for HTTP stream.

Key features of Time

• Get current time in any timezone and format
• Convert times between timezones
• Add or subtract durations from a given time
• Compare two times, returning -1, 0, or 1
• Understand natural language expressions (e.g., "yesterday", "next month")
• Supports both stdio and HTTP stream transports

Use cases of Time

• An AI assistant displays the current time in a user's local timezone
• A scheduling tool converts meeting times across global timezones
• A planner adds a duration (e.g., "2h30m") to a starting time
• A comparison tool determines if one event occurs before another
• A date parser interprets relative phrases like "5 minutes ago"

FAQ from Time

What tools does the Time MCP server provide?

It provides five tools: current_time, relative_time, convert_timezone, add_time, and compare_time. Each accepts parameters like timezone, format, and natural language strings.

How can I install the Time MCP server?

You can run it via Docker (docker run --rm -i theo01/mcp-time:latest), download a pre-built binary from the releases page, install it with go install, or build from source using make install.

What transports are supported?

Two transports are supported: stdio (default, for local integration) and stream (for HTTP server access on a configurable address).

Can I use natural language for time expressions?

Yes. The relative_time tool accepts natural language strings like "yesterday", "5 minutes ago", or "next month", and can optionally use a reference time and timezone.

Does Time support custom time formats?

Yes. Many tools accept a format parameter that can be a predefined format (e.g., RFC3339, Kitchen) or a custom Go layout string.