A Model Context Protocol (MCP) server that provides access to your Granola notes, documents, transcripts, and calendar events using the Granola API.
概览
A Model Context Protocol (MCP) server that provides access to your Granola notes, documents, transcripts, and calendar events using the Granola API. - 🔍 : Search through all your Granola documents/notes - 📝 : Find meeting transcripts by content - 📅 : Search calendar events - 📋 : Search structured note panels - 📄 : Retrieve specific documents by ID - 📊 : List all available documents Add this to your Cursor MCP configuration (usually in .cursor/mcp.json or Cursor Settings): : Replace /absolute/path/to/granola-mcp-server/dist/index.js with the actual absolute path to your built server.
README
Granola MCP Server
A Model Context Protocol (MCP) server that provides access to your Granola notes, documents, transcripts, and calendar events using the Granola API.
Features
- 🔍 Search Notes: Search through all your Granola documents/notes
- 📝 Search Transcripts: Find meeting transcripts by content
- 📅 Search Events: Search calendar events
- 📋 Search Panels: Search structured note panels
- 📄 Get Documents: Retrieve specific documents by ID
- 📊 List Documents: List all available documents
Installation
- Install dependencies:
cd granola-mcp-server
npm install
- Build the server:
npm run build
Configuration in Cursor
Add this to your Cursor MCP configuration (usually in .cursor/mcp.json or Cursor Settings):
{
"mcpServers": {
"granola": {
"command": "node",
"args": ["/absolute/path/to/granola-mcp-server/dist/index.js"]
}
}
}
Important: Replace /absolute/path/to/granola-mcp-server/dist/index.js with the actual absolute path to your built server.
Usage
Once configured, you can use the MCP tools in Cursor:
search_granola_notes- Search documents by querysearch_granola_transcripts- Search meeting transcriptssearch_granola_events- Search calendar eventssearch_granola_panels- Search document panelsget_granola_document- Get a specific documentget_granola_transcript- Get a specific transcriptlist_granola_documents- List all documents
How It Works
The server uses Granola’s API with credentials stored locally at:
~/Library/Application Support/Granola/supabase.json
It fetches data from the Granola API and provides search/retrieval capabilities over:
- Documents (notes)
- Meeting transcripts
- Calendar events
- Document panels (structured note sections)
Development
# Build
npm run build
# Watch mode
npm run dev
# Run directly
npm start
Notes
- Requires Granola to be installed and logged in (credentials are read from local config)
- Data is fetched from the Granola API in real-time
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"granola": {
"command": "node",
"args": ["/absolute/path/to/granola-mcp-server/dist/index.js"]
}
}
}