# Datecalc

> Datecalc is a freemium MCP server for time utilities. MCP server for date differences, duration arithmetic and calendar facts in UTC. 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/datecalc
- **Repository:** https://github.com/pipeworx-io/mcp-datecalc
- **MCP Registry name:** io.github.pipeworx-io/datecalc
- **Categories:** [time utilities](https://ai-powered.com/categories/time-utilities)
- **Listing updated:** 2026-11-18

## About

The README describes this as a gateway-hosted MCP server that does date arithmetic over UTC: measuring the gap between two timestamps, adding or subtracting durations with month-end clamping, and reporting calendar details such as weekday, ISO week, quarter and leap-year status for a given date.

The server is a thin bridge. The npm package forwards each call to a hosted Pipeworx endpoint, so it needs network access and there is no offline mode, even though the marketing text calls the calculations offline. Calls can be made anonymously with a daily cap, or with an optional Pipeworx API key that raises the limit.

It suits developers and AI agents that need reliable date math inside a workflow rather than letting a language model estimate calendar answers.

## Features

- **Date difference calculation:** Returns the signed gap between two ISO-8601 dates or times in milliseconds through weeks, plus a readable summary.
- **Duration arithmetic:** Adds or subtracts years, months, weeks, days, hours, minutes and seconds, returning the new UTC date.
- **Calendar facts lookup:** Reports weekday, day of year, ISO week, quarter, leap-year status and days in the month for a date.
- **Multiple transports:** Available as a remote streamable-HTTP endpoint or as a local stdio package run through npx.
- **Optional API key:** An optional Pipeworx key raises the daily call allowance; without one calls are anonymous and capped.

## Good for

- Calculating elapsed time between events in an agent workflow
- Adding billing or renewal periods to a start date with month-end handling
- Finding the ISO week or quarter for a date in reporting code
- Checking whether a year is a leap year before scheduling logic runs

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `date_diff`: Compute the difference between two dates/times (UTC), returning signed differences in several units and a summary.
- `add_duration`: Add or subtract a duration from a date and return the new UTC date/time.
- `date_info`: Return calendar facts for a date: weekday, day-of-year, ISO week, quarter, leap year, and days in month.

## FAQ

### Does it work without an account?

Yes. The README says calls are anonymous without a key and capped at 50 per day; a free account raises the cap to 200 per day.

### Does the npm package run offline?

No. The README states the stdio bridge forwards every call to the Pipeworx gateway and there is no offline mode.

### Which tools does the pack expose?

The README lists date_diff, add_duration and date_info. The endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.

### Is Datecalc free?

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

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

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

### What are the best alternatives to Datecalc?

The closest alternatives to Datecalc are Timestamp, Duration, Timeapi Io, Timeapi MCP and Days to pad current UTC month to 31.

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

- [Timestamp](https://ai-powered.com/mcp/timestamp): Timestamp is a freemium MCP server for time utilities.
- [Duration](https://ai-powered.com/mcp/duration): Duration 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.
- [Timeapi MCP](https://ai-powered.com/mcp/timeapi-mcp): Timeapi MCP is an open-source MCP server for time utilities.
- [Days to pad current UTC month to 31](https://ai-powered.com/mcp/days-to-pad-current-utc-month-to-31): Days to pad current UTC month to 31 is an MCP server for time utilities.
- [Days in the current UTC month](https://ai-powered.com/mcp/days-in-the-current-utc-month): Days in the current UTC month is an MCP server for time utilities.
- [UTC last day of the current month](https://ai-powered.com/mcp/utc-last-day-of-the-current-month): UTC last day of the current month is an MCP server for time utilities.
- [UTC midpoint day of the current quarter](https://ai-powered.com/mcp/utc-midpoint-day-of-the-current-quarter): UTC midpoint day of the current quarter is an open-source MCP server for time utilities.

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