Connect Granola to Claude Code

Read meeting notes, AI summaries and transcripts from Granola, and manage the webhooks that deliver them. Add Toolspoke to Claude Code once and it can use 12 Granola actions. Your Granola credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Granola and connect it

    Add Granola to a project in your Toolspoke workspace.

    API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    API key
    Granola desktop app → Settings → Connectors → API keys → Create new key, then choose the note scopes. A personal key reads your notes and those shared with you; a workspace key (admins only) reads the workspace's public notes. Needs a Business or Enterprise plan.
  3. Choose what Claude Code may do

    All 12 actions start on. Switch off any of the 3 actions that change something in Granola, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the Granola actions that only read, so they are safe to try first.

  • List notes this key can read, with id, title, owner and timestamps, no summary or transcript
  • Read one note's transcript a page at a time, speaker, text and timestamps per line
  • List the folders this key can see
  • List the workspace spaces this key can see

What Claude Code can do in Granola

9 actions read and 3 delete or permanently change something.

Reads

  • List notes

    List notes this key can read, with id, title, owner and timestamps, no summary or transcript; call get_note for those. Granola only returns notes that already have a generated summary and transcript. Page with cursor while hasMore is true.

  • Get note

    Read one note: AI summary and private notes (as text and markdown), attendees, calendar event, folders and web link. Set include to transcript to add the transcript; a very long one is refused with 413, and get_note_transcript pages it instead.

  • Get note transcript

    Read one note's transcript a page at a time, speaker, text and timestamps per line. Use for transcripts too long for get_note.

  • List folders

    List the folders this key can see. A folder id narrows list_notes and a webhook.

  • List spaces

    List the workspace spaces this key can see. A space id narrows list_notes.

  • List audit events

    List workspace audit events from the last year, newest first. action matches an exact action or a dotted prefix (workspace returns every workspace.* event).

  • List legal holds

    List legal holds on the workspace, the holds that keep notes from being deleted.

  • Get legal hold

    Read one legal hold, its name, description and whether it covers the whole workspace.

  • List webhook endpoints

    List the webhook endpoints that receive note events, with their URL, scopes, events and folders.

Deletes or permanently changes

  • Create webhook endpoint

    Register a URL that Granola notifies about notes. Destructive rather than write: from then on, note events for the chosen scopes go to that address with no further call, which is a standing channel out of the workspace.

  • Update webhook endpoint

    Change a webhook endpoint, its URL, scopes, events or folders, or turn it on or off. Destructive for the same reason as creating one: pointing it at a new URL or widening its scopes sends notes somewhere new.

  • Delete webhook endpoint

    Delete a webhook endpoint. Events stop being delivered to it, and there is no undo.

Granola in Claude Code: questions

Does Claude Code see my Granola credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in Granola?

Yes. Each of the 12 actions can be switched off for a project. Turn off the 3 that change something and Claude Code can only read.

Will 12 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Granola action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Granola call does not run in a sandbox, so it bills nothing.

Try Granola in Claude Code

Free to start, and tool calls cost nothing on any plan.