Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Granola MCP ServerSummarize the action items from my last meeting about the project roadmap"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Granola MCP Server
A Model Context Protocol (MCP) server for integrating Granola.ai meeting intelligence with Claude Desktop and other MCP clients. Access your meetings, notes, and transcripts directly from AI assistants.
⚠️ Disclaimer
This is an unofficial, community-built tool. It is not affiliated with, endorsed by, or supported by Granola, Inc.
This server uses undocumented APIs discovered through network inspection. Use of this tool may violate Granola's Terms of Service. Use at your own risk.
If you are from Granola and would like this repository removed or would like to discuss official API access, please open an issue.
Features
🔍 Meeting Search - Search meetings by title, content, and participants
📝 Full Content Access - Retrieve complete meeting notes in Markdown format
🏢 Workspace Management - List and filter by workspaces (organizations)
📁 Folder Organization - List and filter by document folders
🔄 Real-time API Access - Direct access to Granola's API
🔐 Secure Authentication - Uses your existing Granola credentials
⚡ Smart Caching - 5-minute cache for optimal performance
Prerequisites
Node.js 18+
Granola.ai installed and logged in on macOS
Claude Desktop (or another MCP client)
Installation
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Then restart Claude Desktop.
Available Tools
Tool | Description | Parameters |
| Search meetings by title/content |
|
| Get meeting metadata |
|
| Get full notes as Markdown |
|
| List all workspaces | - |
| List document folders |
|
| Filter meetings by workspace |
|
| Filter meetings by folder |
|
Usage Examples
Once configured, use natural language in Claude:
"Search for meetings about quarterly planning"
"Get the content from yesterday's standup"
"List all my workspaces"
"Show me meetings in the Sales folder"
How It Works
Authentication
The server reads your existing Granola credentials from:
No additional login required - it uses your existing Granola session.
API Integration
Direct REST API calls to Granola's backend
ProseMirror content converted to readable Markdown
In-memory caching with 5-minute TTL
Troubleshooting
"Failed to get access token"
Ensure Granola is installed and you're logged in. The server needs:
Server not appearing in Claude
Verify the config path is correct
Run
npm run buildRestart Claude Desktop completely
Development
Credits & Acknowledgments
This project was inspired by and built upon the reverse-engineering work of:
Joseph Thacker - Detailed blog post on reverse-engineering Granola's API
getprobo/reverse-engineering-granola-api - API documentation and research
Thank you for sharing your findings with the community! 🙏
Related Projects
cobblehillmachine/granola-claude-mcp - Python-based, cache file approach
btn0s/granola-mcp - TypeScript, similar API approach
Contributing
Contributions welcome! Please feel free to submit issues and pull requests.
License
MIT © Eoin Falconer