SavvyCal MCP Server

An MCP (Model Context Protocol) server that connects Claude to your SavvyCal account. Ask Claude about your upcoming meetings, check your availability, book meetings, and manage your scheduling links — all in natural language.

What you can do

• "What meetings do I have this week?" — list upcoming bookings with attendee details and join links
• "When am I free for a 30-minute call next week?" — check available slots for any scheduling link
• "Book a meeting with john@example.com on Tuesday at 2pm" — create a booking directly
• "Cancel my 3pm meeting today" — cancel a scheduled event
• "Turn off my intro-call link while I'm on holiday" — pause/resume scheduling links
• "Show me all my booking types" — list all your scheduling links with status and duration

Tools

Setup

1. Get your SavvyCal API key

1. Log in to SavvyCal
2. Go to Settings → Developer Settings
3. Click Create a token and give it a name (e.g. "Claude MCP")
4. Copy the token — you'll need it in the next step

2. Configure Claude Code (stdio, local use)

Add to your .mcp.json in your project root:

{
  "mcpServers": {
    "savvycal": {
      "command": "npx",
      "args": ["savvycal-mcp-server"],
      "env": {
        "SAVVYCAL_API_KEY": "pt_secret_your_token_here"
      }
    }
  }
}

Or run directly:

SAVVYCAL_API_KEY=pt_secret_your_token_here npx savvycal-mcp-server

3. Configure for HTTP (remote/hosted deployment)

SAVVYCAL_API_KEY=pt_secret_your_token_here TRANSPORT=http PORT=3000 node dist/index.js

The server exposes:

• POST /mcp — MCP endpoint
• GET /health — Health check

Development

# Clone and install
git clone https://github.com/your-username/savvycal-mcp-server
cd savvycal-mcp-server
npm install

# Set your API key
export SAVVYCAL_API_KEY=pt_secret_your_token_here

# Build
npm run build

# Run (stdio)
npm start

# Run (HTTP)
TRANSPORT=http npm start

Environment Variables

Example conversations

Checking your schedule:

"What meetings do I have tomorrow?" "Show me all bookings this month" "Did anyone cancel a meeting recently?"

Checking availability:

"When am I free for a 30-minute intro call next week?" "What slots do I have open on my consultation link for Friday?"

Booking a meeting:

"Book a 30-minute intro call with Sarah (sarah@acme.com) for next Monday at 10am"

Managing links:

"Pause all my scheduling links — I'm going on holiday" "Re-enable my intro-call link" "How many active scheduling links do I have?"

License

MIT