Time

Name: Time
Author: TheoBrigitte

@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

Basic information

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.

Comments

More Productivity MCP servers

Todoist MCP Server

abhiz123

MCP server for Todoist integration enabling natural language task management with Claude

391

ATLAS: Task Management System

cyanheads

A Model Context Protocol (MCP) server for ATLAS, a Neo4j-powered task management system for LLM Agents - implementing a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows. Now with Deep Research.

475