Astrocal MCP server
{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server@latest"
],
"env": {
"ASTROCAL_API_KEY": "<astrocal_api_key>",
"ASTROCAL_API_URL": "https://...",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<astrocal_default_event_type_id>"
}
}
}
}{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server@latest"
],
"env": {
"ASTROCAL_API_KEY": "<astrocal_api_key>",
"ASTROCAL_API_URL": "https://...",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<astrocal_default_event_type_id>"
}
}
}
}{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server@latest"
],
"env": {
"ASTROCAL_API_KEY": "<astrocal_api_key>",
"ASTROCAL_API_URL": "https://...",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<astrocal_default_event_type_id>"
}
}
}
}{
"servers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server@latest"
],
"env": {
"ASTROCAL_API_KEY": "${input:astrocal_api_key}",
"ASTROCAL_API_URL": "${input:astrocal_api_url}",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "${input:astrocal_default_event_type_id}"
}
}
},
"inputs": [
{
"id": "astrocal_api_key",
"type": "promptString",
"description": "Astrocal api key",
"password": true
},
{
"id": "astrocal_api_url",
"type": "promptString",
"description": "Astrocal api url",
"password": true
},
{
"id": "astrocal_default_event_type_id",
"type": "promptString",
"description": "Astrocal default event type id",
"password": true
}
]
}{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server@latest"
],
"env": {
"ASTROCAL_API_KEY": "<astrocal_api_key>",
"ASTROCAL_API_URL": "https://...",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<astrocal_default_event_type_id>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @astrocal/mcp-serverversion 0.1.6
What it does
An MCP server that gives AI agents the ability to check calendar availability, create, cancel, and reschedule meetings through Astrocal's scheduling API. It connects to Google Calendar, Microsoft 365, and CalDAV, and is designed for developers and AI assistants that need programmatic access to scheduling.
- An AI assistant checks availability and books meetings on behalf of users through natural conversation.
- An agent manages meeting rescheduling and cancellations when plans change, automatically notifying invitees.
- An AI system handles waitlist management when all time slots are booked, allowing users to join and check their position.
Tools this server exposes
| Tool | Does |
|---|---|
| check_availability | Check available time slots for a given event type within a date range and timezone. |
| create_booking | Book a meeting at a specific time with invitee details and optional notes. |
| cancel_booking | Cancel an existing booking with an optional reason; the invitee receives a cancellation email. |
| reschedule_booking | Move a booking to a new time with an optional reason for the change. |
| list_bookings | Retrieve bookings with optional filtering by status, event type, or result limit. |
| list_event_types | List all available event types that can be booked. |
| join_waitlist | Add someone to a waitlist for an event type when slots are full. |
| check_waitlist | Check a person's position on a waitlist using their waitlist entry ID. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.