# SavvyCal MCP Server

Connect Claude to your SavvyCal account. List upcoming meetings, check your availability, find open slots, book meetings, and manage your scheduling links — all in natural language without opening a …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add arturkoter/savvycal-mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list arturkoter/savvycal-mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get arturkoter/savvycal-mcp-server savvycal_list_events

# Call a tool
npx -y @smithery/cli@latest tool call arturkoter/savvycal-mcp-server savvycal_list_events '{}'
```

## Direct MCP Connection

Endpoint: `https://savvycal-mcp-server--arturkoter.run.tools`

**Required config:**
- `SAVVYCAL_API_KEY` (query) — Your SavvyCal personal access token (from Settings → Developer Settings)

## Tools (8)

- `savvycal_list_events` — List scheduled (and canceled) meetings from your SavvyCal account.
- `savvycal_get_event` — Fetch full details for a single SavvyCal event by its ID.
- `savvycal_cancel_event` — Cancel a scheduled SavvyCal event. This action cannot be undone.
- `savvycal_create_event` — Book a meeting on a SavvyCal scheduling link for a specific time slot.
- `savvycal_list_scheduling_links` — List all scheduling links in your SavvyCal account.
- `savvycal_get_available_slots` — Get available time slots for a scheduling link within a date range.
- `savvycal_toggle_link` — Enable or disable a SavvyCal scheduling link.
- `savvycal_get_current_user` — Fetch the profile of the currently authenticated SavvyCal user.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get arturkoter/savvycal-mcp-server <tool-name>
```