# Astrocal

Connects scheduling workflows to your AI assistant for slot checking, booking, and waitlists. Useful when an agent needs to handle meetings directly inside chat.

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

## What it does

This MCP server hooks into the Astrocal platform, giving the model eight dedicated tools. The assistant can inspect open intervals across Google Calendar, Microsoft 365, or CalDAV. It books, reschedules, and cancels calls. Cancellations automatically email the invitee.

The toolset handles waitlist entries and supports paid appointments through Stripe Connect. Running it requires `ASTROCAL_API_KEY`. Defining `ASTROCAL_DEFAULT_EVENT_TYPE_ID` saves the model from needing an explicit event ID on every routine request.

Live keys immediately create calendar events and process charges. Test your prompts with `ac_test_*` keys first to avoid accidental emails or payment actions.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.astrocal.dev/mcp`
- Environment variables: `ASTROCAL_API_KEY`, `ASTROCAL_API_URL`, `ASTROCAL_DEFAULT_EVENT_TYPE_ID` — 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: remote server**
```bash
claude mcp add --transport http mcp-server https://api.astrocal.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ASTROCAL_API_KEY=<ASTROCAL_API_KEY> --env ASTROCAL_API_URL=<ASTROCAL_API_URL> --env ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> --transport stdio astrocal -- npx -y @astrocal/mcp-server
```
Replace <…> with your own values

### Codex

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

2. **Platform CLI**
```bash
codex mcp add astrocal --env ASTROCAL_API_KEY=<ASTROCAL_API_KEY> --env ASTROCAL_API_URL=<ASTROCAL_API_URL> --env ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> -- npx -y @astrocal/mcp-server
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add -e ASTROCAL_API_KEY=<ASTROCAL_API_KEY> -e ASTROCAL_API_URL=<ASTROCAL_API_URL> -e ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> astrocal npx -y @astrocal/mcp-server
```
Replace <…> with your own values

## When to use it
- Check open slots across Google Calendar, Microsoft 365, or CalDAV
- Book and reschedule appointments directly from chat
- Collect payments for sessions using Stripe Connect
- Place attendees on a waitlist when dates are fully booked

## Example prompts
- Check if there are open slots for a consultation next week
- Book a meeting for jane@example.com on March 17 at 14:00 UTC
- Reschedule booking book_123 to 15:00 UTC

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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