granola-ai

GranolaAI MCP Server provides an MCP interface to access Granola.ai meeting intelligence locally. It exposes tools that let you search your meeting library, retrieve detailed meeting metadata, fetch full transcripts with speaker labels, access associated documents and notes, and analyze patterns across your meetings. Once the server is running and connected to your Claude Desktop via MCP, you can invoke tools such as search_meetings, get_meeting_details, get_meeting_transcript, get_meeting_documents, and analyze_meeting_patterns through natural language prompts. This enables you to perform complex queries like finding meetings by keyword, extracting full transcripts for a specific meeting, or analyzing participant patterns across a date range, all while keeping data processing local to your machine.

Prerequisites:

• Python 3.12+ installed
• uvx (via the uvx package) installed and available in PATH
• macOS with Granola.ai installed (as applicable)

1. Install the MCP server package

• Using uvx (recommended by the README): uvx granola-mcp-server

2. Configure Claude Desktop to use the MCP server

• macOS Claude Desktop: add an MCP server with command uvx and args [granola-mcp-server] This will point Claude Desktop to run the Granola MCP server locally.

3. Start the MCP server directly during testing

• Run: uv run granola-mcp-server

4. Optional: install from source and sync

• Manual installation: git clone https://github.com/proofgeist/granola-mcp-server cd granola-mcp-server uv sync

5. Optional: Python environment preparation

• Ensure Python 3.12+ is installed
• Install dependencies as needed (via pyproject or hatchling as per project)

6. Verify server is running

• You should be able to connect via MCP protocol and invoke tools like search_meetings, get_meeting_details, etc.

Environment variables:

• GRANOLA_PARSE_PANELS: Enable or disable parsing of document panels for rich notes (default: 1)
• TZ: Override local timezone detection (default: auto-detect)

Common issues:

• If MCP client cannot connect, verify that the uvx command and package name granola-mcp-server are correctly installed and in PATH.
• When using GRANOLA_PARSE_PANELS=0, document panel parsing is disabled; this may be necessary if parsing causes instability with certain documents.
• Ensure that the Granola cache (cache-v4.json) is accessible to the server; read operations depend on the local cache file.

Tips:

• Use uv run granola-mcp-server to test the server in a lightweight environment.
• For manual installations, keep uv sync up to date to pull the latest server code.