granola-mcp

MCP server for accessing Granola meeting notes and transcripts in Claude.

Requirements

• macOS (Granola is macOS-only)
• Granola desktop app installed and logged in
• uv for running the server

Quick Start

One-Line Install

curl -fsSL https://raw.githubusercontent.com/Primary-OS/granola-mcp/main/install.sh | bash

Then restart Claude Desktop.

Manual Install

1. Install uv (if needed)

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "granola": {
      "command": "uvx",
      "args": ["granola-mcp"]
    }
  }
}

3. Restart Claude Desktop

Tools

Usage Examples

Once installed, ask Claude:

• "What meetings did I have this week?"
• "Get the transcript from my call with [company]"
• "Search my meetings for discussions about pricing"
• "Summarize my meeting with John from yesterday"

How It Works

This server reads authentication tokens from Granola's local config file: ~/Library/Application Support/Granola/supabase.json

If tokens are expired, it automatically opens Granola.app to refresh them.

Troubleshooting

"Granola config not found"

• Make sure Granola is installed and you've logged in at least once

"Token expired and auto-refresh failed"

• Open Granola.app manually, then try again

Server not appearing in Claude

• Check that uvx is in your PATH: which uvx
• Restart Claude Desktop completely (quit and reopen)
• Check the Claude Desktop logs for errors

Development

# Clone and install
git clone https://github.com/Primary-OS/granola-mcp
cd granola-mcp

# Run locally
uv run python -m granola_mcp

# Test with Claude Desktop (local dev)
# Add to claude_desktop_config.json:
{
  "mcpServers": {
    "granola-dev": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/granola-mcp", "python", "-m", "granola_mcp"]
    }
  }
}

License

MIT