{"_id":"@astrocal/mcp-server","_rev":"5-6ac32f47414a93d62bb3a93cccd2aa57","name":"@astrocal/mcp-server","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.1":{"name":"@astrocal/mcp-server","version":"0.1.1","keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"author":{"name":"Astrocal"},"license":"MIT","_id":"@astrocal/mcp-server@0.1.1","maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"homepage":"https://github.com/alexgmason/astrocal#readme","bugs":{"url":"https://github.com/alexgmason/astrocal/issues"},"bin":{"astrocal-mcp":"dist/index.js"},"dist":{"shasum":"c3e080d5c6c1c919b265370f59d0e3bf8d2d5410","tarball":"https://registry.npmjs.org/@astrocal/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":4,"integrity":"sha512-aXygaR0KUMNMc4s3pYDp8xAdE80BydnCZ86HijXr0FehJokFrme/Tow98gUQ2MiRpe7gypfBhaSK9gUZ1dy7sA==","signatures":[{"sig":"MEUCIQCfAzLvkP30j5GqSpaQXyrNaSwWyNr96IJ2Xh0vesXwEQIgZ3IUw5NzqmhlYMq13zKHOuqeQTTIv0YMLX0hhmYHP0M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42189},"main":"dist/index.js","type":"module","_from":"file:astrocal-mcp-server-0.1.1.tgz","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"astrocal-alex","email":"alex@astrocal.dev"},"_resolved":"/tmp/2caa652c8cc4ceddc8b7d6fc644f75f3/astrocal-mcp-server-0.1.1.tgz","_integrity":"sha512-aXygaR0KUMNMc4s3pYDp8xAdE80BydnCZ86HijXr0FehJokFrme/Tow98gUQ2MiRpe7gypfBhaSK9gUZ1dy7sA==","repository":{"url":"git+https://github.com/alexgmason/astrocal.git","type":"git","directory":"code/packages/mcp-server"},"_npmVersion":"10.8.2","description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^4.3.6","posthog-node":"^5.24.17","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.0.18","typescript":"^5.9.3","@types/node":"^25.2.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1773009261046_0.8845751517987683","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@astrocal/mcp-server","version":"0.1.2","keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"author":{"name":"Astrocal"},"license":"MIT","_id":"@astrocal/mcp-server@0.1.2","maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"homepage":"https://astrocal.dev","bugs":{"url":"https://github.com/astrocal-dev/mcp-server/issues"},"bin":{"astrocal-mcp":"dist/index.js"},"dist":{"shasum":"4b86b7089704a2dbd78f4802d58427f352e97e46","tarball":"https://registry.npmjs.org/@astrocal/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":4,"integrity":"sha512-KA/Ww5VJZwRv7Oy3ZL/hxoIyMg2bpPaeurhj4mgrAp+8fVJEtcK/Rmg4ugBb5FVp6xqVCi0t+8zQwFYId2sn3A==","signatures":[{"sig":"MEQCIG579+n4G+Q6HukC7o+/TRa4lyS2CC80o1QZSlaQkPmCAiASpjmK47uhmpuFUQPyiFHX7QxUJFGtlzyHXXsFg2N89w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42927},"main":"dist/index.js","type":"module","_from":"file:astrocal-mcp-server-0.1.2.tgz","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"astrocal-alex","email":"alex@astrocal.dev"},"_resolved":"/tmp/022f9c43783cd9ab0ea9f31100918661/astrocal-mcp-server-0.1.2.tgz","_integrity":"sha512-KA/Ww5VJZwRv7Oy3ZL/hxoIyMg2bpPaeurhj4mgrAp+8fVJEtcK/Rmg4ugBb5FVp6xqVCi0t+8zQwFYId2sn3A==","repository":{"url":"git+https://github.com/astrocal-dev/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^4.3.6","posthog-node":"^5.24.17","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.5.1","vitest":"^4.0.18","typescript":"^5.9.3","@types/node":"^25.2.3"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1773016529507_0.3582144863716745","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@astrocal/mcp-server","version":"0.1.3","keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"author":{"name":"Astrocal"},"license":"MIT","_id":"@astrocal/mcp-server@0.1.3","maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"homepage":"https://astrocal.dev","bugs":{"url":"https://github.com/astrocal-dev/mcp-server/issues"},"bin":{"astrocal-mcp":"dist/index.js"},"dist":{"shasum":"18cc3944cd2864ec95af251429f65023b0b00ffa","tarball":"https://registry.npmjs.org/@astrocal/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":4,"integrity":"sha512-fvI2khxdnpMQu6A+e3hOfj7UzuE9PLVrPgN/pvNjTwpZxwLtkGhfdGJmIB5WDg+6HauKk/GZJTSQP2Xek6EZkQ==","signatures":[{"sig":"MEUCIDkK40jHR94GmkkRcJBxhWMl/9axTZ7W6tHRKusEYHmjAiEA9Yoon4b7Fh4aWFQasOuhQ44vDIcSBUtgDmKgjVNx+sE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45215},"main":"dist/index.js","type":"module","_from":"file:astrocal-mcp-server-0.1.3.tgz","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"dev.astrocal/mcp-server","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"astrocal-alex","email":"alex@astrocal.dev"},"_resolved":"/tmp/e38b58287d4d5cc1b1f6ab7e13b61c97/astrocal-mcp-server-0.1.3.tgz","_integrity":"sha512-fvI2khxdnpMQu6A+e3hOfj7UzuE9PLVrPgN/pvNjTwpZxwLtkGhfdGJmIB5WDg+6HauKk/GZJTSQP2Xek6EZkQ==","repository":{"url":"git+https://github.com/astrocal-dev/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.4.3","posthog-node":"^5.35.6","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","vitest":"^4.1.7","typescript":"^5.9.3","@types/node":"^25.9.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.3_1780411736606_0.34122012930012535","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@astrocal/mcp-server","version":"0.1.4","keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"author":{"name":"Astrocal"},"license":"MIT","_id":"@astrocal/mcp-server@0.1.4","maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"homepage":"https://astrocal.dev","bugs":{"url":"https://github.com/astrocal-dev/mcp-server/issues"},"bin":{"astrocal-mcp":"dist/index.js"},"dist":{"shasum":"c550b321e049ba0577cb5aea9dea9c16447630c8","tarball":"https://registry.npmjs.org/@astrocal/mcp-server/-/mcp-server-0.1.4.tgz","fileCount":4,"integrity":"sha512-lNX6764Gu43KEIBb8RyPLfqV9SpDZNh2HYrLtdgCk+895T0N+13uslxxMwhXo63+bX9gv/gBIxQUWcobc5canw==","signatures":[{"sig":"MEYCIQD+Lm5Ahqx3ZnXqoFQ+9l5bsYV9f1u6iJgDer+y2b8uCwIhALb03XHuMa7briPO6ROZS01ikeRrgMspdyaAwVqEP/NC","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45215},"main":"dist/index.js","type":"module","_from":"file:astrocal-mcp-server-0.1.4.tgz","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"dev.astrocal/mcp-server","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src/","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"astrocal-alex","email":"alex@astrocal.dev"},"_resolved":"/tmp/9fd90c5bdb479c23aac8669cb2c356ce/astrocal-mcp-server-0.1.4.tgz","_integrity":"sha512-lNX6764Gu43KEIBb8RyPLfqV9SpDZNh2HYrLtdgCk+895T0N+13uslxxMwhXo63+bX9gv/gBIxQUWcobc5canw==","repository":{"url":"git+https://github.com/astrocal-dev/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.4.3","posthog-node":"^5.35.6","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","vitest":"^4.1.7","typescript":"^5.9.3","@types/node":"^25.9.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.4_1780417143045_0.9894204930745383","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@astrocal/mcp-server","mcpName":"dev.astrocal/mcp-server","version":"0.1.6","type":"module","description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","author":{"name":"Astrocal"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/astrocal-dev/mcp-server.git"},"homepage":"https://astrocal.dev","bugs":{"url":"https://github.com/astrocal-dev/mcp-server/issues"},"main":"dist/index.js","types":"dist/index.d.ts","bin":{"astrocal-mcp":"dist/index.js"},"exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","posthog-node":"^5.35.6","zod":"^4.4.3"},"devDependencies":{"@anthropic-ai/mcpb":"2.1.2","@types/node":"^25.9.1","tsup":"^8.5.1","tsx":"^4.22.3","typescript":"^5.9.3","vitest":"^4.1.7","@astrocal/shared":"0.0.1"},"keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"scripts":{"build":"tsup","dev":"tsx watch src/index.ts","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","lint":"eslint src/","bundle":"pnpm build && mcpb validate manifest.json && mcpb pack . astrocal.mcpb"},"_id":"@astrocal/mcp-server@0.1.6","_integrity":"sha512-sZMU36wVjzbFULDHLv2L+2duuZNXpTaaoSUw8hktRE+uQlCdy6vVSFkOvFNTr35oJlKJGQXVZduq1D9TRQVrfQ==","_resolved":"/tmp/7a0666171ccb8464f763d36df8dc697b/astrocal-mcp-server-0.1.6.tgz","_from":"file:astrocal-mcp-server-0.1.6.tgz","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-sZMU36wVjzbFULDHLv2L+2duuZNXpTaaoSUw8hktRE+uQlCdy6vVSFkOvFNTr35oJlKJGQXVZduq1D9TRQVrfQ==","shasum":"cecb4aa05626b95718955f3e2984cdcb25450345","tarball":"https://registry.npmjs.org/@astrocal/mcp-server/-/mcp-server-0.1.6.tgz","fileCount":4,"unpackedSize":46198,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFebFyORgpw4M9WwVEPl46hLXo0dLYKIvEHaAxNGAm2qAiANo5v2JKLbfe7kKBR79rHatgkYsviHGpVT0RMp39OZDw=="}]},"_npmUser":{"name":"astrocal-alex","email":"alex@astrocal.dev"},"directories":{},"maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.6_1782336687422_0.14614309851791085"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T22:34:20.987Z","modified":"2026-06-24T21:31:27.717Z","0.1.1":"2026-03-08T22:34:21.195Z","0.1.2":"2026-03-09T00:35:29.660Z","0.1.3":"2026-06-02T14:48:56.768Z","0.1.4":"2026-06-02T16:19:03.194Z","0.1.6":"2026-06-24T21:31:27.596Z"},"bugs":{"url":"https://github.com/astrocal-dev/mcp-server/issues"},"author":{"name":"Astrocal"},"license":"MIT","homepage":"https://astrocal.dev","keywords":["mcp","model-context-protocol","scheduling","calendar","ai-agents","booking","astrocal","claude","claude-desktop"],"repository":{"type":"git","url":"git+https://github.com/astrocal-dev/mcp-server.git"},"description":"MCP server for Astrocal scheduling API — manage bookings from AI agents via the Model Context Protocol","maintainers":[{"name":"astrocal-alex","email":"alex@astrocal.dev"}],"readme":"# @astrocal/mcp-server\n\n**Give your AI agents the power to schedule meetings.** The official [Model Context Protocol](https://modelcontextprotocol.io) server for [Astrocal](https://astrocal.dev) — the API-first scheduling platform built for developers and AI agents.\n\nWorks with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Your AI assistant can check availability, book meetings, cancel, reschedule, and manage waitlists — all through natural conversation.\n\n[Get your API key](https://astrocal.dev/dashboard/api-keys) | [Documentation](https://astrocal.dev/docs) | [API Reference](https://astrocal.dev/docs/api-reference)\n\n## Why Astrocal for AI Agents?\n\n- **Purpose-built for AI** — Not a Calendly bolt-on. Astrocal's [scheduling API](https://astrocal.dev/docs/api-reference) was designed from day one for programmatic and AI-agent access.\n- **8 tools, zero config** — Check availability, book, cancel, reschedule, list event types, manage waitlists. Everything an agent needs.\n- **Calendar sync built in** — Connects to Google Calendar, Microsoft 365, and CalDAV. Your agent books against real availability.\n- **Payments included** — [Stripe Connect integration](https://astrocal.dev/docs/guides/payments) means your agent can book paid consultations, not just free meetings.\n- **Sandbox mode** — Test with `ac_test_*` keys. No emails sent, no calendar events created, no charges made.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"astrocal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@astrocal/mcp-server\"],\n      \"env\": {\n        \"ASTROCAL_API_KEY\": \"ac_live_xxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop and the scheduling tools will be available immediately.\n\n### Other MCP Clients\n\nInstall globally:\n\n```bash\nnpm install -g @astrocal/mcp-server\n```\n\nRun:\n\n```bash\nASTROCAL_API_KEY=ac_live_xxx astrocal-mcp\n```\n\n## Environment Variables\n\n| Variable                         | Required | Description                                                               |\n| -------------------------------- | -------- | ------------------------------------------------------------------------- |\n| `ASTROCAL_API_KEY`               | Yes      | Your Astrocal API key ([get one free](https://astrocal.dev/signup))       |\n| `ASTROCAL_API_URL`               | No       | API base URL (default: `https://api.astrocal.dev`)                        |\n| `ASTROCAL_DEFAULT_EVENT_TYPE_ID` | No       | Default event type ID — your agent won't need to specify it on every call |\n\n## Available Tools\n\n### `check_availability`\n\nCheck available time slots for booking.\n\n- `event_type_id` (string, optional) — Event type to check. Optional if `ASTROCAL_DEFAULT_EVENT_TYPE_ID` is set.\n- `start_date` (string, required) — Start date in ISO 8601 format (e.g., `2026-03-15`)\n- `end_date` (string, required) — End date in ISO 8601 format (e.g., `2026-03-22`)\n- `timezone` (string, optional) — IANA timezone (e.g., `America/New_York`). Defaults to UTC.\n\n### `create_booking`\n\nBook a meeting at a specific time.\n\n- `event_type_id` (string, optional) — Event type to book. Optional if default is set.\n- `start_time` (string, required) — ISO 8601 datetime (e.g., `2026-03-15T14:00:00Z`)\n- `invitee_name` (string, required) — Full name of the person booking\n- `invitee_email` (string, required) — Email address for calendar invitation\n- `invitee_timezone` (string, optional) — IANA timezone. Defaults to UTC.\n- `notes` (string, optional) — Meeting notes (max 1000 characters)\n\n### `cancel_booking`\n\nCancel an existing booking. The invitee receives a cancellation email automatically.\n\n- `booking_id` (string, required) — ID of the booking to cancel\n- `reason` (string, optional) — Cancellation reason (max 500 characters)\n\n### `reschedule_booking`\n\nReschedule a booking to a new time. Check availability first.\n\n- `booking_id` (string, required) — ID of the booking to reschedule\n- `new_start_time` (string, required) — New time in ISO 8601 format\n- `reason` (string, optional) — Reason for rescheduling (max 500 characters)\n\n### `list_bookings`\n\nList bookings with optional filters.\n\n- `status` (string, optional) — Filter: `confirmed`, `cancelled`, or `pending_payment`\n- `limit` (number, optional) — Max results (default: 10, max: 100)\n- `event_type_id` (string, optional) — Filter by event type\n\n### `list_event_types`\n\nList available event types that can be booked. No input required.\n\n### `join_waitlist`\n\nJoin the waitlist when all slots are full.\n\n- `event_type_id` (string, required) — Event type to join the waitlist for\n- `name` (string, required) — Full name\n- `email` (string, required) — Email address\n- `preferred_times` (string, optional) — Preferred time ranges or notes\n\n### `check_waitlist`\n\nCheck your position on a waitlist.\n\n- `waitlist_entry_id` (string, required) — Waitlist entry ID returned from `join_waitlist`\n\n## Example Conversation\n\n> **User:** \"What meetings can I book?\"\n>\n> **Agent:** _calls `list_event_types`_ — \"You have two event types: a 30-minute consultation (free) and a 1-hour strategy session ($50).\"\n>\n> **User:** \"Check if next Tuesday at 2pm is free for a consultation\"\n>\n> **Agent:** _calls `check_availability`_ — \"Tuesday at 2pm is available.\"\n>\n> **User:** \"Book it for jane@example.com\"\n>\n> **Agent:** _calls `create_booking`_ — \"Done! Meeting confirmed for Tuesday, March 17 at 2:00 PM UTC with Jane. A calendar invitation has been sent.\"\n>\n> **User:** \"Actually, move it to 3pm\"\n>\n> **Agent:** _calls `reschedule_booking`_ — \"Rescheduled to 3:00 PM. Jane has been notified.\"\n\n## Part of the Astrocal Platform\n\nThis MCP server is one of several ways to integrate with [Astrocal](https://astrocal.dev):\n\n- **[REST API](https://astrocal.dev/docs/api-reference)** — Full scheduling API with OpenAPI 3.1 spec\n- **[React SDK](https://www.npmjs.com/package/@astrocal/react)** (`@astrocal/react`) — Typed hooks, provider, and booking widget for React apps\n- **[Embeddable Widget](https://www.npmjs.com/package/@astrocal/widget)** (`@astrocal/widget`) — Drop-in booking UI for any website\n- **[Dashboard](https://astrocal.dev/dashboard)** — Manage event types, bookings, team members, and billing\n- **[Webhooks](https://astrocal.dev/docs/guides/webhooks)** — Real-time notifications for booking events\n\n[Create a free account](https://astrocal.dev/signup) to get started.\n\n## Links\n\n- [Astrocal Website](https://astrocal.dev)\n- [Documentation](https://astrocal.dev/docs)\n- [API Reference](https://astrocal.dev/docs/api-reference)\n- [Dashboard](https://astrocal.dev/dashboard)\n- [GitHub](https://github.com/astrocal-dev/mcp-server)\n- [Issues](https://github.com/astrocal-dev/mcp-server/issues)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}