Skip to content
MCP server

Datecalc

MCP server for date differences, duration arithmetic and calendar facts in UTC

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Datecalc

Datecalc is a freemium MCP server for time utilities. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/datecalc/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "datecalc": {
      "url": "https://gateway.pipeworx.io/datecalc/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Free anonymous tier (50 calls/day) and free account (200 calls/day); paid credits and subscriptions for higher use.

Prices change. Check pipeworx.io before you buy.

Datecalc 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.

How AIPoweredBot checks servers