Skip to main content
Glama
twanlass

Granola MCP Server

by twanlass
README.md
# Granola MCP Server

An MCP (Model Context Protocol) server that provides tools for accessing Granola meeting transcripts and AI-generated notes.

## Requirements

- Node.js 20+
- Granola desktop app installed and logged in

## Installation

```bash
git clone https://github.com/twanlass/granola-mcp.git
cd granola-mcp
npm install
npm run build
```

## Claude Desktop Configuration

Add this to your Claude Desktop config file:

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

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

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

Replace `/path/to/granola-mcp` with the actual path to this repository.

## Claude Code Configuration

Run this command to add the MCP server to Claude Code:

```bash
claude mcp add granola node /path/to/granola-mcp/dist/index.js
```

## Available Tools

| Tool | Description |
|------|-------------|
| `get_recent_documents` | List recent meeting documents |
| `get_document` | Get AI notes (default) or transcript for a document |
| `search_documents` | Search documents by title |

### Options

`get_document` returns AI-generated notes by default. Pass `transcript: true` to get the raw transcript instead.

## How Granola Credentials Work

The server reads credentials from Granola's config file at:
```
~/Library/Application Support/Granola/supabase.json
```

This file is created automatically when you log into the Granola desktop app. No additional configuration is required.

TDQS

A3.8/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: listing recent documents, retrieving a specific document's content, and searching by title. There is no overlap or ambiguity between them.

Naming Consistency4/5

Tool names follow a consistent verb_noun pattern ('get_' and 'search_'). Minor deviation exists between singular 'document' and plural 'documents', but overall naming is predictable and readable.

Tool Count5/5

With only 3 tools, the server is well-scoped for its purpose of accessing meeting documents. Each tool earns its place and the count is appropriate for a focused read-only domain.

Completeness4/5

The server covers listing, retrieval, and search, which are the core read operations for meeting documents. While update/delete are absent, they are likely outside the intended scope, so the surface feels complete for its purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues