gcal-mcp

Dedalus MCP server for Google Calendar API v3 (read + write) using Google OAuth.

Quickstart

cd /Users/annyzhou/Desktop/gcal-mcp
uv sync

Google OAuth (required)

1. In Google Cloud Console:

• Enable Google Calendar API
• Create OAuth client ID → Desktop app
• Download the OAuth client JSON

If you skip enabling the Calendar API, Google will return HTTP 403 like: Google Calendar API has not been used in project ... before or it is disabled.

2. Point the repo at your OAuth client JSON:

export GOOGLE_OAUTH_CREDENTIALS="/absolute/path/to/oauth-client.json"

3. Run the one-time auth flow (opens a browser, stores tokens locally):

uv run python -c 'from src.gcal_oauth import ensure_gcal_access_token; ensure_gcal_access_token(interactive=True)'

Tokens are stored at ~/.config/gcal-mcp/tokens.json by default (override with GCAL_TOKEN_PATH).

Run the MCP server

export DEDALUS_AS_URL="https://as.dedaluslabs.ai"   # optional
export DEDALUS_API_KEY="..."                        # required when auth is enabled
uv run python -m src.main

Tools

Tools are defined in src/gcal.py (see gcal_tools list).

License

MIT