# MCP Time

> MCP Time is an open-source MCP server for time utilities. MCP server giving AI clients date, time, timezone and calendar utilities. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/mcpcentral-io/mcp-time
- **MCP Registry name:** io.github.mcpcentral-io/mcp-time
- **Categories:** [time utilities](https://ai-powered.com/categories/time-utilities)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Model Context Protocol server that gives language models access to date and time functions. It ships in two modes: an npm package that runs locally over stdio, and a Streamable HTTP endpoint hosted on Cloudflare Workers that can be reached remotely without installing anything.

The server exposes six tools covering current time in a chosen timezone, relative phrasing such as "2 hours ago", days in a month, Unix millisecond timestamps, conversion between IANA timezones, and week-of-year numbers. The README includes sample arguments for each tool and notes that the inspector should show all six as listed.

It suits developers wiring date handling into an assistant or agent who want a ready-made tool instead of writing their own. The README also states plainly that the example server has no authentication or security measures, so it should be reviewed before exposing it to untrusted users.

## Features

- **Current time lookup:** Returns the current date and time in a requested format and timezone.
- **Timezone conversion:** Converts a time between IANA timezones.
- **Relative time phrasing:** Produces human-readable strings such as in five minutes or two hours ago.
- **Unix timestamp output:** Gives millisecond Unix timestamps for a supplied date-time.
- **Calendar helpers:** Reports days in a given month and week or ISO week numbers for a date.
- **Dual transport support:** Runs over stdio via npm or over remote Streamable HTTP.

## Good for

- Letting an assistant answer what time it is in another city
- Converting meeting times between timezones inside an agent workflow
- Turning raw timestamps into relative phrases for chat responses
- Checking month lengths or ISO week numbers during scheduling tasks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-time https://mcp.time.mcpcentral.io
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.time.mcpcentral.io
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-time": {
      "url": "https://mcp.time.mcpcentral.io"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-time": {
      "type": "http",
      "url": "https://mcp.time.mcpcentral.io"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-time": {
      "serverUrl": "https://mcp.time.mcpcentral.io"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-time": {
      "type": "http",
      "url": "https://mcp.time.mcpcentral.io"
    }
  }
}
```

## Tools

- `current_time`: Get the current date and time in specified formats and timezones.
- `relative_time`: Get a human-readable relative time string.
- `days_in_month`: Get the number of days in a specific month.
- `get_timestamp`: Get the Unix timestamp (milliseconds) for a given time.
- `convert_time`: Convert a time between different IANA timezones.
- `get_week_year`: Get the week number and ISO week number for a given date.

## FAQ

### How can I run this server locally?

The README gives an npm option using npx @mcpcentral/mcp-time over stdio, with a JSON client configuration example. It also describes running a local HTTP endpoint with npx wrangler dev on port 8787.

### Does the server require authentication?

No. The README states that this example server has no authentication or security measures implemented.

### Which tools are available?

The README lists six tools: current_time, relative_time, days_in_month, get_timestamp, convert_time and get_week_year.

### Is MCP Time free?

Yes. MCP Time is open source, so you can use and self-host it for free.

### How do I add MCP Time to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-time https://mcp.time.mcpcentral.io

### What are the best alternatives to MCP Time?

The closest alternatives to MCP Time are Time MCP, Timeapi MCP, Timestamp, Datecalc and Timezone Clock.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Time MCP](https://ai-powered.com/mcp/time-mcp): Time MCP is an open-source MCP server for time utilities.
- [Timeapi MCP](https://ai-powered.com/mcp/timeapi-mcp): Timeapi MCP is an open-source MCP server for time utilities.
- [Timestamp](https://ai-powered.com/mcp/timestamp): Timestamp is a freemium MCP server for time utilities.
- [Datecalc](https://ai-powered.com/mcp/datecalc): Datecalc is a freemium MCP server for time utilities.
- [Timezone Clock](https://ai-powered.com/mcp/timezone-clock): Timezone Clock is an MCP server for time utilities.
- [Etc/UTC clock](https://ai-powered.com/mcp/etc-utc-clock): Etc/UTC clock is an MCP server for time utilities.
- [Europe/Amsterdam clock](https://ai-powered.com/mcp/europe-amsterdam-clock): Europe/Amsterdam clock is an MCP server for time utilities.
- [UTC second day of the current month](https://ai-powered.com/mcp/utc-second-day-of-the-current-month): UTC second day of the current month is an MCP server for time utilities.

---
Source: https://ai-powered.com/mcp/mcp-time-2
