Granola MCP Server

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

git clone https://github.com/EoinFalconer/granola-mcp-server.git
cd granola-mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "granola": {
      "command": "node",
      "args": ["/path/to/granola-mcp-server/index.js"]
    }
  }
}

Then restart Claude Desktop.

Available Tools

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:

~/Library/Application Support/Granola/supabase.json

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:

~/Library/Application Support/Granola/supabase.json

Server not appearing in Claude

1. Verify the config path is correct
2. Run npm run build
3. Restart Claude Desktop completely

Development

npm run build      # Compile TypeScript
npm run watch      # Watch mode
npm run dev        # Build and run

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