Granola AI MCP Server

Granola MCP Server (Experimental)

An experimental Model Context Protocol (MCP) server for integrating Granola.ai meeting intelligence with Claude Desktop. This uses Granola's local cache. I don't have any idea how Granola updates or maintains that cache. My guess is that it's doing a rolling context window, but storing long term notes up in AWS. So, YMMV. Use at your own risk. I will likely add a cache shipper at some point since we don't have access to Gronala's data in the cloud.

Features

• Meeting Search: Search meetings by title, content, participants, and transcript content
• Meeting Details: Get comprehensive meeting metadata with local timezone display
• Full Transcript Access: Retrieve complete meeting conversations with speaker identification
• Rich Document Content: Access actual meeting notes, summaries, and structured content
• Pattern Analysis: Analyze patterns across meetings (participants, frequency, topics)
• Timezone Intelligence: All timestamps automatically display in your local timezone
• Real-time Integration: Seamlessly connects to your actual Granola meeting data

Quick Start

Prerequisites

• Python 3.12+
• uv package manager
• macOS with Granola.ai installed
• Claude Desktop application
• Granola cache file at ~/Library/Application Support/Granola/cache-v3.json

Installation

1. Clone the repository to your home directory:

   cd ~
   git clone <repository-url>
   cd granola-ai-mcp-server
   

   Important: Clone to your home directory (~) rather than ~/Documents to avoid macOS permission issues with Claude Desktop.

2. Install dependencies with uv:

   uv sync
   

3. Test the installation:

   uv run python test_server.py
   

4. Configure Claude Desktop by adding to your claude_desktop_config.json:

   {
     "mcpServers": {
       "granola": {
         "command": "/Users/YOUR_USERNAME/granola-ai-mcp-server/.venv/bin/granola-mcp-server",
         "args": [],
         "env": {}
       }
     }
   }
   

   Important:

   • Replace YOUR_USERNAME with your actual macOS username
   • Use the direct path to the virtual environment's script (not uv run) to avoid working directory issues
   • The path should point to your home directory installation

5. Restart Claude Desktop to load the MCP server:

   # Quit Claude completely
   osascript -e 'quit app "Claude"'
   # Reopen Claude
   open -a "Claude"
   

Available Tools

search_meetings

Search meetings by query string.

Parameters:
- query (string): Search query for meetings
- limit (integer, optional): Maximum number of results (default: 10)

get_meeting_details

Get detailed information about a specific meeting.

Parameters:
- meeting_id (string): Meeting ID to retrieve details for

get_meeting_transcript

Get transcript for a specific meeting.

Parameters:
- meeting_id (string): Meeting ID to get transcript for

get_meeting_documents

Get documents associated with a meeting.

Parameters:
- meeting_id (string): Meeting ID to get documents for

analyze_meeting_patterns

Analyze patterns across multiple meetings.

Parameters:
- pattern_type (string): Type of pattern to analyze ('topics', 'participants', 'frequency')
- date_range (object, optional): Date range for analysis with start_date and end_date

Usage Examples

Once configured with Claude Desktop, you can use natural language to interact with your Granola meetings:

Basic Queries

• "Search for meetings about quarterly planning"
• "Show me yesterday's meetings"
• "Find meetings with David from this week"

Transcript Access

• "Get the transcript from yesterday's ProofChat meeting"
• "What was discussed in the Float rollback planning meeting?"
• "Show me the full conversation from the David Tibbi meeting"

Content Analysis

• "Analyze participant patterns from last month"
• "What documents are associated with the product review meeting?"
• "Search for mentions of 'schema labeling' in meeting transcripts"

Recent Meeting Intelligence

The server automatically detects and provides access to:

• Full transcripts from recent meetings (25,000+ characters)
• Meeting content including notes and summaries
• Participant information and speaker identification
• Local timezone display for all meeting times

Development

Running Tests

uv run python test_server.py

Running the Server Directly

uv run granola-mcp-server

Adding Dependencies

uv add package-name

Configuration

Claude Desktop Config Locations

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Granola Cache Location

The server reads from Granola's cache