README.md
MCP server for the Calendly API to manage events and availability.
@nimblebraininc/calendly
MCP server for the Calendly API. Browse event types, view and filter scheduled meetings, inspect invitee details, check availability windows, and cancel events.
Tools
| Tool | Description |
|---|---|
get_current_user |
Get the authenticated user's profile |
list_event_types |
List the user's event types |
list_scheduled_events |
List scheduled events with optional filters |
get_event |
Get details of a specific scheduled event |
list_invitees |
List invitees for a scheduled event |
cancel_event |
Cancel a scheduled event with an optional reason |
check_availability |
Get available time slots for an event type |
Setup
- Get a Personal Access Token from Calendly Integrations
- Configure via mpak:
mpak config set @nimblebraininc/calendly api_key your_token_here
Development
npm install
npm run build
npm run check # format, lint, typecheck, tests
License
MIT
Tools (7)
get_current_userGet the authenticated user's profilelist_event_typesList the user's event typeslist_scheduled_eventsList scheduled events with optional filtersget_eventGet details of a specific scheduled eventlist_inviteesList invitees for a scheduled eventcancel_eventCancel a scheduled event with an optional reasoncheck_availabilityGet available time slots for an event typeEnvironment Variables
CALENDLY_API_KEYrequiredPersonal Access Token from Calendly IntegrationsConfiguration
claude_desktop_config.json
{"mcpServers": {"calendly": {"command": "npx", "args": ["-y", "@nimblebraininc/calendly"], "env": {"CALENDLY_API_KEY": "your_token_here"}}}}Try it
→List all my scheduled events for the upcoming week.
→Check availability for my 30-minute consultation event type.
→Cancel the meeting with John Doe scheduled for tomorrow and provide the reason as 'scheduling conflict'.
→Who is invited to the project sync meeting scheduled for Friday?