GranolaAI MCP Server
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
- Granola cache file at
~/Library/Application Support/Granola/cache-v3.json
One-Click Install for Cursor (Recommended)
Click the button above to automatically add the Granola MCP server to Cursor.
Note: This requires uv to be installed and Granola.ai to be running on macOS.
Manual Installation (Claude Desktop)
Click to expand manual setup instructions
-
Clone the repository to your home directory:
cd ~ git clone https://github.com/proofgeist/granola-ai-mcp-server cd granola-ai-mcp-server
Important: Clone to your home directory (
~) rather than~/Documentsto avoid macOS permission issues with Claude Desktop. -
Install dependencies with uv:
uv sync -
Test the installation:
uv run python test_server.py
-
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_USERNAMEwith 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
- Replace
-
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 file at:
~/Library/Application Support/Granola/cache-v3.json
Security & Privacy
- ✅ 100% Local Processing - All data stays on your machine
- ✅ No External API Calls - No data sent to external services
- ✅ Granola Permissions Respected - Uses existing Granola.ai access controls
- ✅ Read-Only Access - Server only reads from Granola's cache
Performance & Capabilities
- Fast Loading: Sub-2 second cache loading for hundreds of meetings
- Rich Content: Extracts 25,000+ character transcripts and meeting notes
- Efficient Search: Multi-field search across titles, content, participants, and transcripts
- Memory Optimized: Lazy loading with intelligent content parsing
- Timezone Smart: Automatic local timezone detection and display
- Production Ready: Successfully processes real Granola data (11.7MB cache files)
- Scalable: Handles large datasets with 500+ transcript segments per meeting
Current Status
🚀 PRODUCTION READY - Successfully tested with real Granola.ai data including:
- ✅ 39+ meetings parsed and searchable
- ✅ 28 full transcripts with complete conversations
- ✅ Rich meeting content from notes, summaries, and structured data
- ✅ Timezone intelligence showing times like "17:04" instead of "21:04 UTC"
- ✅ Speaker identification and conversation flow
- ✅ Yesterday's meetings fully accessible with detailed content
Troubleshooting
Common Issues
"Cache file not found"
- Ensure Granola.ai is installed and has processed some meetings
- Check that the cache file exists:
ls -la "~/Library/Application Support/Granola/cache-v3.json"
"uv command not found"
- Install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh - Or use pip fallback in Claude config:
"command": "python"
"Permission denied" or "Operation not permitted"
-
Most common issue on macOS: This happens when the server is installed in
~/Documentsor other protected folders -
Solution 1 (Recommended): Move the installation to your home directory:
mv ~/Documents/granola-ai-mcp-server ~/granola-ai-mcp-server cd ~/granola-ai-mcp-server uv sync # Rebuild venv with correct paths
Then update the path in
claude_desktop_config.json -
Solution 2: Grant Claude Desktop Full Disk Access:
- Open System Settings → Privacy & Security → Full Disk Access
- Click the lock icon and authenticate
- Click "+" and add
/Applications/Claude.app - Toggle Claude to "On"
- Restart Claude Desktop
"Current directory does not exist"
- This error occurs when using
uv runwith the--directoryflag - Use the direct path to the venv script instead (see Installation step 4)
Server not appearing in Claude Desktop
- Verify the absolute path in your Claude config
- Check Claude Desktop logs:
~/Library/Logs/Claude/mcp-server-granola.log - Look for Python errors in the logs
- Ensure the path doesn't contain spaces or special characters
- Restart Claude Desktop after config changes
"Failed to spawn process" or "No such file or directory"
- The Python shebang in the venv script points to the wrong location
- Run
uv syncin the project directory to rebuild the venv - Verify the script exists:
ls -la ~/granola-ai-mcp-server/.venv/bin/granola-mcp-server
Meeting notes appear empty in Claude
- Granola sometimes stores rich notes inside
documentPanelsrather thannotes_plain - This server now reads those panels by default; set
GRANOLA_PARSE_PANELS=0in the environment to disable - Run
python test_real_cache.pyto verify that panel-backed notes produce content
Metadata
Release files for iflow-mcp_proofgeist-granola-ai-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0.tar.gz | 16.6 kB | Without provenance | Details for iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0-py3-none-any.whl |
Total release size: 30.9 kB
Release files / iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0.tar.gz
| Download URL | iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 16.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bc3340d23997c8da41fc953bcba59960196f67f1a1ee80127a35c7c5ba8129c0
|
|
BLAKE2b-256 checksum How to use checksums |
7a0d5eaff9a9d9ae10717cc4ff60780d9c7a22cecd5f858b9691136bf5464378
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_proofgeist_granola_ai_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 14.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bad3f2bb245fc103c02b52c137740b400e6f4126c0b255a77282dbce24777650
|
|
BLAKE2b-256 checksum How to use checksums |
baabc48c7984b0fa7c77aec8c4e3f5f798d3180ccc09c83e7a76653582935b65
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_proofgeist-granola-ai-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.