mcp-time

Overview

The mcp-time server is a Model Context Protocol implementation that enables AI assistants to perform complex time and date operations. It offers tools for getting current time, converting between timezones, handling relative time expressions, comparing times, and formatting dates flexibly. The server supports both stdio and HTTP stream transports, making it versatile for different integration scenarios. The Go implementation ensures good performance and reliability, with comprehensive error handling for various time formats and edge cases.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• current_time

  Get the current time in any timezone and format

  Try:What time is it in Tokyo?Try:Get current time in RFC3339 format
• relative_time

  Get a time based on a relative natural language expression

  Try:What was the date 3 weeks ago?Try:When is next Tuesday?
• convert_timezone

  Convert a given time between timezones

  Try:Convert 2:30 PM EST to Tokyo timeTry:What is 8 AM PST in Berlin?
• add_time

  Add or subtract a duration from a given time

  Try:What time will it be in 45 minutes?Try:Subtract 2 days from now
• compare_time

  Compare two times and determine their relationship

  Try:Is 3 PM EST before 8 PM GMT?Try:Which comes first: Monday or Tuesday?

Comparable tools

Installation

{
  "mcpServers": {
    "mcp-time": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theo.foobar/mcp-time"
      ]
    }
  }
}

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

FAQ

What time formats does the server support?

The server supports various predefined formats (RFC3339, Kitchen, etc.) and custom Go layout strings. It can parse most common time formats automatically.

How does the server handle timezone conversions?

It uses IANA timezone names (like 'America/New_York') for accurate timezone conversions and respects daylight saving time automatically.

Compare mcp-time with