# Timeapi Io

> Timeapi Io is a freemium MCP server for time utilities. Keyless time lookups, zone conversion and DST info for TimeAPI.io via MCP gateway. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/timeapi-io
- **Repository:** https://github.com/pipeworx-io/mcp-timeapi-io
- **MCP Registry name:** io.github.pipeworx-io/timeapi-io
- **Categories:** [time utilities](https://ai-powered.com/categories/time-utilities)
- **Listing updated:** 2026-11-18

## About

The README says this server wraps the TimeAPI.io public API and exposes its time queries to MCP clients. Lookups can be made by IANA timezone name, by latitude and longitude, or by IP address, and the server also converts a datetime from one zone to another and reports zone metadata such as UTC offset and whether daylight saving time is active.

Requests are forwarded through the Pipeworx gateway rather than run locally. The npm package is a stdio bridge that calls the hosted endpoint, so it needs network access and has no offline mode. Calls are anonymous by default, and an optional Pipeworx API key raises the daily cap.

It suits developers and agents that need timezone-aware times or date arithmetic without managing their own time data. The listing notes that this is an unofficial integration, and that the endpoint also lists shared gateway meta-tools alongside the pack's own.

## Features

- **Current time by location:** Returns the current time for an IANA timezone, a latitude and longitude, or an IP address.
- **Timezone conversion:** Converts a datetime from one IANA zone to another, with an option for DST ambiguity.
- **Zone metadata:** Reports UTC offset, DST offset, DST start and end, and whether DST is active for a zone.
- **ISO 8601 output:** Returns full zoned datetime strings in ISO 8601 format.
- **Date parsing and weekday:** Parses custom-format dates into ISO and returns the day of the week for a date.
- **Zone directory:** Lists the IANA timezone names supported by TimeAPI.io for valid inputs.

## Good for

- Converting a meeting time between two timezones inside an agent workflow
- Checking whether daylight saving time is active in a given zone
- Finding the current local time for a user from their coordinates or IP
- Validating timezone names before passing them to other tools
- Normalising custom-format date strings to ISO 8601

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http timeapi-io https://gateway.pipeworx.io/timeapi-io/mcp
```

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

```sh
https://gateway.pipeworx.io/timeapi-io/mcp
```

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

```json
{
  "mcpServers": {
    "timeapi-io": {
      "url": "https://gateway.pipeworx.io/timeapi-io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "timeapi-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/timeapi-io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "timeapi-io": {
      "serverUrl": "https://gateway.pipeworx.io/timeapi-io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "timeapi-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/timeapi-io/mcp"
    }
  }
}
```

## Tools

- `current_time`: Current time in a timezone.
- `current_time_coordinate`: Current time at latitude and longitude.
- `current_time_ip`: Current time at an IP address.
- `current_iso_zoned_date_time`: ISO zoned datetime for a timezone.
- `current_zone_info`: Zone info including DST flag and UTC offset.
- `convert_time_zone`: Convert datetime between zones.
- `day_of_the_week`: Day of week for a date.
- `list_zones`: List supported IANA zones.
- `translate_to_iso`: Parse a custom-format date to ISO.

## FAQ

### Do I need an API key to use it?

No. The npm package README says calls are anonymous without a key, capped at 50 per day. A free Pipeworx account raises the cap to 200 per day.

### Does it run locally?

The npm package is a local stdio bridge that forwards every call to the hosted Pipeworx gateway, so network access is required and there is no offline mode.

### Which tools does the endpoint list?

The README lists nine pack tools and says the endpoint also lists roughly 30 shared Pipeworx meta-tools, such as ask_pipeworx.

### Is Timeapi Io free?

Timeapi Io has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Timeapi Io to Claude Code?

Run this command in your terminal: claude mcp add --transport http timeapi-io https://gateway.pipeworx.io/timeapi-io/mcp

### What are the best alternatives to Timeapi Io?

The closest alternatives to Timeapi Io are Timeapi MCP, Timestamp, Timezone Clock, Datecalc and Europe/Athens clock.

## Where this comes from

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

## Alternatives

- [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.
- [Timezone Clock](https://ai-powered.com/mcp/timezone-clock): Timezone Clock is an MCP server for time utilities.
- [Datecalc](https://ai-powered.com/mcp/datecalc): Datecalc is a freemium MCP server for time utilities.
- [Europe/Athens clock](https://ai-powered.com/mcp/europe-athens-clock): Europe/Athens clock is an MCP server for time utilities.
- [Asia/Taipei clock](https://ai-powered.com/mcp/asia-taipei-clock): Asia/Taipei clock is an MCP server for time utilities.
- [UTC ISO time only](https://ai-powered.com/mcp/utc-iso-time-only): UTC ISO time only is an open-source MCP server for time utilities.
- [Asia/Jerusalem clock](https://ai-powered.com/mcp/asia-jerusalem-clock): Asia/Jerusalem clock is an MCP server for time utilities.

---
Source: https://ai-powered.com/mcp/timeapi-io
