Granola Mcp Server

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)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ArcadeAI
• Source: ArcadeAI/granola-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.