Time

@TheoBrigitte

About Time

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 compl

#time #date #datetime #timezone #natural-language #relative-time #convert-timezone #current-time #add-time #compare-time

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "theo01/mcp-time:latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Productivity MCP servers

post bridge

jack friks

post bridge is a remote MCP server that lets your AI agent schedule and publish social media posts across 9 platforms — Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Connect accounts

My AskAI

Use My AskAI to find product, setup, integration, API, feature, pricing, and troubleshooting information. Search the public knowledge base, read complete documentation and OpenAPI files, and estimate pricing from monthly

Plyto

Plyto is an agentic CRM for small businesses, and this server exposes the whole platform to the AI you already use. Connect Claude, Cursor, or any MCP-compatible assistant with a per-business API key and your agent can c

crosscode-cli

amsultan2010

Multiplayer coding in the agentic era through an MCP server for real-time codebase sync between your agents.

Time

modelcontextprotocol

Model Context Protocol Servers

88.2K