playbooks

home / mcp / granola mcp server

Granola MCP Server

Provides access to Granola notes, transcripts, events, and documents via MCP for fast search and retrieval.

Installation
Add the following to your MCP client configuration file.

Configuration

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

The Granola MCP Server lets you access and search your Granola notes, transcripts, calendar events, and documents directly through MCP clients. It enables fast discovery and retrieval by surfacing powerful search and retrieval endpoints over your Granola data.

How to use

You connect to the Granola MCP Server from an MCP client (such as Cursor) and enable a local, real-time bridge to your Granola data. Once configured, you can search notes, transcripts, events, and document panels, or fetch specific documents and transcripts by ID. Use the provided tools to perform targeted queries and retrieve exact items from your Granola collection.

How to install

Prerequisites: Node.js and npm must be installed on your system. Ensure Granola is installed and you are logged in so credentials are available locally.

1. Install dependencies in the server directory.

npm install

2. Build the server.

npm run build

3. Run in development (watch) mode if you want automatic rebuilds during development.

npm run dev

4. Start the server directly when ready to run in production or a stable dev session.

npm start

Configuration in Cursor

Add this MCP configuration to your Cursor settings to expose the Granola MCP Server locally. The server runs as a stdio process started by Node and pointed to the built entry file.

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

Available tools

search_granola_notes

Search through Granola documents and notes by a query.

search_granola_transcripts

Search meeting transcripts by content.

search_granola_events

Search calendar events.

search_granola_panels

Search structured note panels within documents.

get_granola_document

Retrieve a specific document by its ID.

get_granola_transcript

Retrieve a specific transcript by its ID.

list_granola_documents

List all available documents.