{"_id":"@bookcall/bookcall-mcp","name":"@bookcall/bookcall-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@bookcall/bookcall-mcp","version":"1.0.0","private":false,"description":"MCP Server for Bookcall.io - AI assistant integration for meeting scheduling","main":"dist/index.js","types":"dist/index.d.ts","type":"module","bin":{"bookcall-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js"},"keywords":["mcp","model-context-protocol","bookcall","ai","scheduling","calendar"],"author":{"name":"Bookcall"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/bookcall-io/bookcall.git","directory":"mcp-server"},"homepage":"https://bookcall.io/docs/api","_id":"@bookcall/bookcall-mcp@1.0.0","gitHead":"dd656a83b83e3fd4fe7900a7ef7426ac645bfe56","bugs":{"url":"https://github.com/bookcall-io/bookcall/issues"},"_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-FWGWX59U33BcbpB4ZlyMWQxx+tRzsrdqQNgroMscxeeUVsEyIsi/7JXOgdBz56xnuw0LS+8GCePgMdP7LO7h9w==","shasum":"0de09d1640e68f52cd287de3ad752fb52e08f95a","tarball":"https://registry.npmjs.org/@bookcall/bookcall-mcp/-/bookcall-mcp-1.0.0.tgz","fileCount":10,"unpackedSize":36810,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDFddp7YPYtau5qNHGmwg0CuHt3kz1uQq7c8AjV9a4oiQIhAMHIyByPi2IcjMXHK5plnbkf86HHQaf5FHFIDyXsSfeS"}]},"_npmUser":{"name":"bookcall","email":"accounts+npm@bookcall.io"},"directories":{},"maintainers":[{"name":"bookcall","email":"accounts+npm@bookcall.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bookcall-mcp_1.0.0_1771164363376_0.4946164952143066"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-15T14:06:03.299Z","1.0.0":"2026-02-15T14:06:03.553Z","modified":"2026-02-15T14:06:03.795Z"},"maintainers":[{"name":"bookcall","email":"accounts+npm@bookcall.io"}],"description":"MCP Server for Bookcall.io - AI assistant integration for meeting scheduling","homepage":"https://bookcall.io/docs/api","keywords":["mcp","model-context-protocol","bookcall","ai","scheduling","calendar"],"repository":{"type":"git","url":"git+https://github.com/bookcall-io/bookcall.git","directory":"mcp-server"},"author":{"name":"Bookcall"},"bugs":{"url":"https://github.com/bookcall-io/bookcall/issues"},"license":"MIT","readme":"# Bookcall MCP Server\n\nMCP (Model Context Protocol) Server for [Bookcall.io](https://bookcall.io) - enable AI assistants to manage your meeting schedule.\n\n## Local Development\n\n### Build\n\n```bash\ncd mcp-server\nbun install\nbun run build\n```\n\n### Test Locally\n\nRun the server directly to verify it starts:\n\n```bash\nBOOKCALL_API_KEY=bk_live_xxx BOOKCALL_API_URL=http://localhost:3000 bun run dist/index.js\n```\n\nOr use the MCP Inspector for interactive testing:\n\n```bash\nBOOKCALL_API_KEY=bk_live_xxx BOOKCALL_API_URL=http://localhost:3000 \\\n  npx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## Setup\n\n1. Get your API key from [Bookcall Settings](https://bookcall.io/settings/api-keys)\n2. Build the MCP server (see above)\n3. Configure your MCP client with the path to the built server\n\n### Claude Code Configuration\n\nAdd to `~/.claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bookcall\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bookcall/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"BOOKCALL_API_KEY\": \"bk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"bookcall\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bookcall/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"BOOKCALL_API_KEY\": \"bk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Note:** Replace `/path/to/bookcall` with the actual path to your bookcall directory.\n\n## Available Tools\n\n### list_meeting_pages\n\nList your meeting pages. Use this to get meeting page IDs needed for creating bookings.\n\n**Parameters:**\n- `active` (boolean, optional): Filter to active pages only (default: true)\n- `limit` (number, optional): Max results (1-100, default: 20)\n- `cursor` (string, optional): Pagination cursor\n\n**Example:**\n```\n\"What meeting pages do I have?\"\n\"Show me my booking pages\"\n```\n\n### get_availability\n\nGet available time slots for booking meetings.\n\n**Parameters:**\n- `days` (number, optional): Days to look ahead (1-90, default: 7)\n- `tz` (string, optional): IANA timezone (e.g., \"America/New_York\")\n- `limit` (number, optional): Max results (1-100, default: 50)\n- `cursor` (string, optional): Pagination cursor\n- `meeting_page_id` (string, optional): Filter to specific meeting page\n\n**Example:**\n```\n\"What time slots are available next week?\"\n\"Show me availability for the next 3 days in Pacific time\"\n```\n\n### get_day_events\n\nGet all events and bookings for a specific date.\n\n**Parameters:**\n- `date` (string, required): Date in YYYY-MM-DD format\n- `tz` (string, optional): IANA timezone\n\n**Example:**\n```\n\"What's on my calendar for tomorrow?\"\n\"Show me all meetings on January 30th\"\n```\n\n### list_bookings\n\nList all bookings with optional status filter.\n\n**Parameters:**\n- `status` (string, optional): pending, confirmed, cancelled, pending_reschedule\n- `tz` (string, optional): IANA timezone\n- `limit` (number, optional): Max results (1-100, default: 20)\n- `cursor` (string, optional): Pagination cursor\n\n**Example:**\n```\n\"Show me my upcoming bookings\"\n\"List all cancelled meetings\"\n```\n\n### get_booking\n\nGet details of a specific booking.\n\n**Parameters:**\n- `id` (string, required): Booking ID (UUID)\n\n**Example:**\n```\n\"Get details for booking abc-123-def\"\n```\n\n### create_booking\n\nCreate a new booking.\n\n**Parameters:**\n- `meeting_page_id` (string, required): Meeting page ID\n- `start` (string, required): Start datetime (ISO 8601)\n- `attendee_name` (string, required): Guest name\n- `attendee_email` (string, required): Guest email\n- `notes` (string, optional): Meeting notes\n\n**Example:**\n```\n\"Book a meeting with John Smith (john@example.com) for tomorrow at 2pm\"\n```\n\n### cancel_booking\n\nCancel an existing booking.\n\n**Parameters:**\n- `id` (string, required): Booking ID\n- `reason` (string, optional): Cancellation reason\n\n**Example:**\n```\n\"Cancel the booking with ID abc-123-def\"\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BOOKCALL_API_KEY` | Yes | Your Bookcall API key |\n| `BOOKCALL_API_URL` | No | API base URL (default: https://bookcall.io) |\n\n## API Key Scopes\n\nYour API key needs the following scopes for full functionality:\n\n- `availability:read` - Query available slots\n- `meeting_pages:read` - List and view meeting pages\n- `bookings:read` - List and view bookings\n- `bookings:create` - Create new bookings\n- `bookings:cancel` - Cancel bookings\n- `events:read` - View calendar events\n\n## Rate Limits\n\n- 60 requests per minute per API key\n- Exceeding the limit returns a 429 error\n\n## Support\n\n- Documentation: https://bookcall.io/docs/api\n- Issues: https://github.com/bookcall/bookcall-mcp-server/issues\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-8e2899c1cdc9a4761da182e0aba0161b"}