Granola MCP Server

An Arcade MCP server that exposes Granola meeting intelligence — notes, transcripts, attendees, and calendar metadata — as tools for any MCP-compatible client (Claude Code, Cursor, etc.).

Built on arcade-mcp-server with OAuth 2.1 Resource Server authentication via Arcade Cloud.

Tools

Tool	Description
list_meetings	List meetings with optional date-range filters and cursor pagination. Returns metadata only (no notes/transcript).
get_meeting	Get full metadata for a single meeting — attendees, calendar event, folders, duration estimate.
get_meeting_transcript	Get the verbatim transcript with speaker labels, timestamps, and optional speaker filtering.

All tools require a GRANOLA_API_KEY (Enterprise API key) which is injected as a server-side secret — it is never exposed to the LLM or MCP client.

Prerequisites

• Python 3.10+
• uv package manager
• A Granola Enterprise API key

Quick Start

# 1. Install dependencies
make install

# 2. Configure your API key
cp .env.example .env
# Edit .env and add your Granola API key

# 3. Start the server (HTTP on port 8000)
make dev

The server is now running at http://localhost:8000/mcp. Point your MCP client to this exact URL and start querying your meetings.

Authentication

This server uses OAuth 2.1 Resource Server authentication. Incoming requests are validated against Arcade Cloud's authorization server using JWT tokens signed with Ed25519. The server:

• Validates token signatures via JWKS from https://cloud.arcade.dev/.well-known/jwks/oauth2
• Verifies the issuer is https://cloud.arcade.dev/oauth2
• Checks the audience matches the server's canonical URL
• Maps the email claim to the user identity for Arcade tool authorization

Configuration

Environment Variable	Description
GRANOLA_API_KEY	Granola Enterprise API key (required)

Development

make install   # Install all dependencies (including dev extras)
make test      # Run tests with coverage
make lint      # Run linting and type checking
make build     # Build wheel

Project Structure

arcade_granola/
├── __main__.py          # Server entrypoint, resource server auth config
├── auth.py              # API key auth provider
├── client.py            # Async HTTP client for Granola's public API
├── models.py            # Pydantic models for API responses
└── tools/
    ├── _common.py       # Shared helpers (client factory, URL builders)
    └── meetings.py      # Meeting tools (list, get, transcript)