# TheoBrigitte/mcp-time [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/TheoBrigitte/mcp-time  
**GitHub Stars:** 25  
**npm Downloads (last month):** 501  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/theobrigitte-mcp-time

## Description
MCP server which provides utilities to work with time and dates, with natural language, multiple formats and timezone convertion capabilities.

## Tools
Capabilities this server exposes over MCP:

- **add_time** — Adds or subtracts a duration from a given time.
- **compare_time** — Compares two times. Returns -1 if the first time is before the second, 0 if they are equal, and 1 if the first time is after the second.
- **convert_timezone** — Converts a time from one timezone to another.
- **current_time** — Returns the current time.
- **relative_time** — Returns a time based on a relative natural language expression.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What TheoBrigitte/mcp-time MCP server does

TheoBrigitte/mcp-time MCP server exposes date and time operations through the Model Context Protocol. It is intended for MCP clients that need to answer time-related questions, interpret relative date expressions, or perform calculations across timezones. The implementation supports both local client connections and network access through its stream transport.

The server can return the current time, interpret expressions such as “5 minutes ago” or “next month,” add or subtract durations, convert values between timezones, and compare two timestamps. Output formatting can use predefined formats such as RFC3339 and Kitchen, or custom Go time layouts where supported by the tool.

## How it works

MCP clients call one of five tools. `current_time` produces the current time for a selected timezone and format. `relative_time` resolves a natural-language expression against either the current time or a supplied reference time. `add_time` applies a duration such as `2h30m`, `-1h`, or `24h` to an input time.

`convert_timezone` parses an input time and renders it in another timezone. Input and output timezone fields are optional where the server can use its defaults. `compare_time` evaluates two values, including timezone information when provided, and returns `-1`, `0`, or `1` to indicate whether the first value is earlier than, equal to, or later than the second.

## Setup and configuration

TheoBrigitte/mcp-time MCP server can be launched through the published npm package with Node.js installed:

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

Docker is another documented stdio option, using the `theo01/mcp-time:latest` image. A native `mcp-time` binary can also be installed from the project releases, with Go, or by building the repository. The default transport is stdio. For network use, start the binary with `--transport stream`; `--address` controls the stream HTTP endpoint and defaults to `http://localhost:8080/mcp`. Logging can be enabled with `--log-file`.

## Tools and capabilities

The available capabilities are:

- Read the current time in an IANA timezone.
- Resolve relative natural-language dates and times.
- Add or subtract durations from an input time.
- Convert times between source and destination timezones.
- Compare timezone-aware time values.
- Format results with predefined or custom layouts.

## Limitations and notes

The server is focused on time and date operations rather than calendars, reminders, scheduling, or external clock and calendar services. It does not require credentials or an external API key according to the documented setup. Timezone-aware requests should use IANA timezone names when the relevant tool parameter calls for them, such as `America/New_York` or `Europe/London`.

The project documents compatibility with MCP clients including Cursor and Claude Desktop. It also lists Claude Code and other MCP clients as possible integrations, but client-specific configuration may vary. The repository is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/theobrigitte-mcp-time/readme_