# Chronary

Hands your agent calendar access: events, availability and meeting-time search. Useful when scheduling calls straight from an AI chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Chronary
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Chronary/chronary-mcp
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/chronary

## What it does

Chronary is an MCP server that wires a calendar API into your AI client. The agent gets 50 tools: it creates and cancels events, hunts for open slots, maintains availability rules, and manages webhooks plus iCal subscriptions. Some tools are flagged destructive — deleting a calendar, cancelling an event, revoking a key. Whether to ask for confirmation is up to the host.

It runs through `npx -y @chronary/mcp`, so there is no install step. You will need a Chronary account, an API key from the console starting with `chr_sk_`, and Node.js 18 or newer on the machine running the client. The key goes into `CHRONARY_API_KEY`.

All 50 tools burn tokens on every request. For a narrow workflow, the `--tools` flag keeps only the listed tools in context. Windsurf's Cascade caps you at 100 tools across every MCP server and 20 calls per prompt, so filtering stops being optional once you stack servers. On Windows, `spawn` cannot resolve `npx.cmd` — write the config with `cmd /c npx ...` instead.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.chronary.ai/mcp`
- Environment variables: `CHRONARY_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e CHRONARY_API_KEY=<CHRONARY_API_KEY> -- npx -y @chronary/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http chronary https://api.chronary.ai/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add chronary --url https://api.chronary.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add chronary --env CHRONARY_API_KEY=<CHRONARY_API_KEY> -- npx -y @chronary/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chronary": {
            "url": "https://api.chronary.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chronary": {
            "command": "npx",
            "args": [
                "-y",
                "@chronary/mcp"
            ],
            "env": {
                "CHRONARY_API_KEY": "<CHRONARY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chronary": {
            "type": "http",
            "url": "https://api.chronary.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chronary": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@chronary/mcp"
            ],
            "env": {
                "CHRONARY_API_KEY": "<CHRONARY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http chronary https://api.chronary.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e CHRONARY_API_KEY=<CHRONARY_API_KEY> chronary npx -y @chronary/mcp
```
Replace <…> with your own values

## When to use it
- find a shared open slot across several attendees
- create a calendar event from an agent chat
- set availability rules for booking
- subscribe to an outside calendar over iCal and sync it
- check the audit log and API usage

## Example prompts
- Find a time for a team meeting next week and create the event
- Show me everything on my calendar tomorrow
- Set availability rules so I only take meetings on Tuesdays and Thursdays

## Similar
- [google-calendar](https://affpapa.org/en/nevibecode/skills/membrane-google-calendar.md) — skill · 337 installs
- [calendar-mcp](https://affpapa.org/en/nevibecode/mcp/calendar-mcp.md) — MCP server · ★ 27
- [Temporal Cortex Calendar MCP](https://affpapa.org/en/nevibecode/mcp/temporal-cortex-calendar-mcp.md) — MCP server · ★ 13
- [recipe-plan-weekly-schedule](https://affpapa.org/en/nevibecode/skills/recipe-plan-weekly-schedule.md) — skill · 30800 installs
- [recipe-reschedule-meeting](https://affpapa.org/en/nevibecode/skills/recipe-reschedule-meeting.md) — skill · 30400 installs
- [calendar-automation](https://affpapa.org/en/nevibecode/skills/calendar-automation.md) — skill · 6100 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