# Timestamp

> Timestamp is a freemium MCP server for time utilities. MCP server converting Unix timestamps, ISO dates and relative times, keyless and UTC-based. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, vscode
- **Website:** https://pipeworx.io/packs/timestamp
- **Repository:** https://github.com/pipeworx-io/mcp-timestamp
- **MCP Registry name:** io.github.pipeworx-io/timestamp
- **Categories:** [time utilities](https://ai-powered.com/categories/time-utilities)
- **Listing updated:** 2026-11-18

## About

The README describes four tools: one turns a Unix timestamp into an ISO-8601 UTC date with human-readable forms, and it detects seconds versus milliseconds by magnitude unless told otherwise. A second parses an ISO-8601 or other common date string back into seconds and milliseconds, a third returns the current UTC time in both formats, and a fourth phrases a date relative to now or to a chosen reference, such as "2 hours ago" or "in 3 days".

The server is hosted by Pipeworx at a streamable-HTTP gateway endpoint, and an npm stdio bridge is also published. The product page says these conversions need no API key. The README says the endpoint also lists shared gateway meta-tools alongside the four pack tools, and that the npm bridge lists only the pack's tools unless an environment flag is set.

This suits developers and agents that need date arithmetic or formatting inside an AI workflow without writing conversion code themselves. Calls made without a key are capped daily, and a free Pipeworx account raises the cap.

## Features

- **Timestamp to ISO conversion:** Converts a Unix timestamp into an ISO-8601 UTC date with human-readable forms.
- **Seconds or milliseconds detection:** Infers the timestamp unit from its magnitude, with an option to override it.
- **Date string to timestamp:** Parses ISO-8601 or other parseable date strings into seconds and milliseconds.
- **Current UTC time:** Returns the present time as both an ISO-8601 string and Unix timestamps.
- **Relative time phrasing:** Expresses a date as a relative phrase such as "2 hours ago" against now or a given reference.

## Good for

- Converting API timestamps into readable UTC dates inside an agent workflow
- Turning ISO dates from user input into Unix timestamps for queries
- Generating human-friendly relative times like "3 days ago" in responses
- Fetching the current UTC time for scheduling or logging steps

## Install

### Claude Code (Terminal)

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

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

```sh
https://gateway.pipeworx.io/timestamp/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `from_timestamp`: Convert a Unix timestamp to an ISO-8601 UTC date and human forms.
- `to_timestamp`: Convert an ISO-8601 or other parseable date string to a Unix timestamp.
- `now`: Return the current UTC time as ISO-8601 and Unix timestamp.
- `relative_time`: Humanize a date relative to now or a given reference time.

## FAQ

### Does it need an API key?

The product page says the conversion tools are keyless. The registry entry says an optional Pipeworx API key is accepted; without it calls are anonymous and capped daily, and a free key raises the cap.

### Which transports are supported?

The registry entry lists stdio via the npm package @pipeworx/mcp-timestamp and streamable-HTTP at the gateway endpoint.

### Does it work offline?

The README says the npm bridge forwards every call to the Pipeworx gateway and that there is no offline mode, although the tool descriptions call the conversions offline.

### How many tools does the endpoint expose?

The README says the four pack tools are listed alongside roughly 30 shared Pipeworx meta-tools on the hosted endpoint, while the npm bridge lists only the pack's tools by default.

### Is Timestamp free?

Timestamp has a free plan, with paid plans for more usage or features.

### How do I add Timestamp to Claude Code?

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

### What are the best alternatives to Timestamp?

The closest alternatives to Timestamp are Datecalc, Timeapi Io, Duration, UTC ISO time only and Timeapi MCP.

## 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

- [Datecalc](https://ai-powered.com/mcp/datecalc): Datecalc is a freemium MCP server for time utilities.
- [Timeapi Io](https://ai-powered.com/mcp/timeapi-io): Timeapi Io is a freemium MCP server for time utilities.
- [Duration](https://ai-powered.com/mcp/duration): Duration is a freemium 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.
- [Timeapi MCP](https://ai-powered.com/mcp/timeapi-mcp): Timeapi MCP is an open-source MCP server for time utilities.
- [UTC ISO semester 1-2](https://ai-powered.com/mcp/utc-iso-semester-1-2): UTC ISO semester 1-2 is an MCP server for time utilities.
- [RFC 3339 UTC stamp](https://ai-powered.com/mcp/rfc-3339-utc-stamp): RFC 3339 UTC stamp is an MCP server for time utilities.
- [Unix epoch milliseconds](https://ai-powered.com/mcp/unix-epoch-milliseconds): Unix epoch milliseconds is an MCP server for time utilities.

---
Source: https://ai-powered.com/mcp/timestamp
