# Date Calculator

The Date Calculator MCP server for Claude Code counts days, shifts dates and finds public holidays by country. It handles calendar calculations through an MCP connection.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: onlinealarmkur
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/onlinealarmkur/date-calculator-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/date-calculator

## What it does

The server finds the gap between dates, moves a date by years, months, weeks or days, and returns public holidays for a country or region. Calculations can omit selected weekdays and holidays; otherwise, both remain part of the count. Dates follow the Gregorian calendar and use `YYYY-MM-DD`.

Connect to `https://mcp.onlinealarmkur.com/` over Streamable HTTP; the service requires no authentication. Holiday calculations use the national calendar unless a region code is supplied. Request limits apply. When the shared daily holiday lookup budget runs out, holiday features pause until `00:00 UTC`; calculations that do not use holidays remain available.

## Requirements
- Remote server: `https://mcp.onlinealarmkur.com/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http date-calculator-mcp https://mcp.onlinealarmkur.com/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add date-calculator --url https://mcp.onlinealarmkur.com/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "date-calculator": {
            "url": "https://mcp.onlinealarmkur.com/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "date-calculator": {
            "type": "http",
            "url": "https://mcp.onlinealarmkur.com/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http date-calculator https://mcp.onlinealarmkur.com/
```

## When to use it
- count working days between two dates
- move a date forward or backward by a chosen period
- find public holidays for a country or region
- look up supported countries and region codes

## Example prompts
- Count working days between two dates in Germany, leaving out Saturdays, Sundays and public holidays.
- What date falls 90 days after 15 January 2027?
- Show Turkey’s public holidays for 2027.

## Similar
- [event-date-selection](https://affpapa.org/en/nevibecode/skills/event-date-selection.md) — skill · 6800 installs
- [i18n-date-patterns](https://affpapa.org/en/nevibecode/skills/i18n-date-patterns.md) — skill · 216 installs
- [date-range-analyzer](https://affpapa.org/en/nevibecode/skills/date-range-analyzer.md) — skill · 1 install
- [date-calculation](https://affpapa.org/en/nevibecode/rules/date-calculation.md) — rule · ★ 880 repo stars
- [calculator-mcp-server](https://affpapa.org/en/nevibecode/mcp/calculator-mcp-server.md) — MCP server · 4412 installs
- [Calculator](https://affpapa.org/en/nevibecode/mcp/calculator.md) — MCP server · 2021 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
