How do I install the Granola skill?

Run npx skillmds@latest add dvcrn/granola-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Granola safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Granola?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Granola free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Granola?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Granola by dvcrn — Agent Skill

Name: Granola
Rating: 4.2 (5 reviews)
Author: dvcrn

Granola

Access Granola AI meeting notes via MCP (mcporter). Query meetings, list by date range, get full details, and pull verbatim transcripts. Use when the user asks about meeting notes, what was discussed, action items, decisions, or anything from their meetings. Also handles OAuth token refresh when calls fail with auth errors.

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

Granola MCP

Meeting notes AI connected via mcporter call granola.<tool>.

Tools

granola.query_granola_meetings  query=<string> [document_ids=<uuid[]>]
granola.list_meetings           [time_range=this_week|last_week|last_30_days|custom] [custom_start=<ISO>] [custom_end=<ISO>]
granola.get_meetings            meeting_ids=<uuid[]>  (max 10)
granola.get_meeting_transcript  meeting_id=<uuid>

Usage Pattern

For open-ended questions ("what did we discuss about X?"), use query_granola_meetings
For listing meetings in a range, use list_meetings
For full details on specific meetings, use get_meetings with IDs from list results
For exact quotes or verbatim content, use get_meeting_transcript

Prefer query_granola_meetings over list+get for natural language questions. Responses include citation links (e.g. [[0]](url)). Preserve these in replies so the user can click through to original notes.

Setup

Complete the Granola OAuth flow at https://mcp-auth.granola.ai/oauth2/authorize
Save credentials to config/granola_oauth.json with keys: client_id, refresh_token, access_token, token_endpoint
Configure config/mcporter.json with the Granola MCP server entry and Authorization: Bearer <token> header
(Optional) Set up a cron job to run scripts/refresh_token.sh periodically, since OAuth tokens expire every ~6 hours

Auth & Token Refresh

If a call fails with 401/auth error:

bash {baseDir}/scripts/refresh_token.sh

The script reads config/granola_oauth.json, posts to the token endpoint (https://mcp-auth.granola.ai/oauth2/token), and updates both config/granola_oauth.json and config/mcporter.json with the new access token.

Then retry the call. If refresh also fails, the user needs to re-authenticate manually via the OAuth flow above.

Config Files

config/granola_oauth.json — OAuth credentials (client_id, refresh_token, access_token, token_endpoint). Contains secrets; do not commit.
config/mcporter.json — MCP server config with bearer token header. Contains secrets; do not commit.

---name: granola-3description: Access Granola AI meeting notes via MCP (mcporter). Query meetings, list by date range, get full details, and pull verbatim transcripts. Use when the user asks about meeting notes, what was discussed, action items, decisions, or anything from their meetings. Also handles OAuth token refresh when calls fail with auth errors.--- # Granola MCP Meeting notes AI connected via `mcporter call granola.<tool>`. ## Tools ``` granola.query_granola_meetings query=<string> [document_ids=<uuid[]>] granola.list_meetings [time_range=this_week|last_week|last_30_days|custom] [custom_start=<ISO>] [custom_end=<ISO>] granola.get_meetings meeting_ids=<uuid[]> (max 10) granola.get_meeting_transcript meeting_id=<uuid> ``` ## Usage Pattern 1. For open-ended questions ("what did we discuss about X?"), use `query_granola_meetings` 2. For listing meetings in a range, use `list_meetings` 3. For full details on specific meetings, use `get_meetings` with IDs from list results 4. For exact quotes or verbatim content, use `get_meeting_transcript` Prefer `query_granola_meetings` over list+get for natural language questions. Responses include citation links (e.g. `[[0]](url)`). Preserve these in replies so the user can click through to original notes. ## Setup 1. Complete the Granola OAuth flow at `https://mcp-auth.granola.ai/oauth2/authorize` 2. Save credentials to `config/granola_oauth.json` with keys: `client_id`, `refresh_token`, `access_token`, `token_endpoint` 3. Configure `config/mcporter.json` with the Granola MCP server entry and `Authorization: Bearer <token>` header 4. (Optional) Set up a cron job to run `scripts/refresh_token.sh` periodically, since OAuth tokens expire every ~6 hours ## Auth & Token Refresh **If a call fails with 401/auth error:** ```bash bash {baseDir}/scripts/refresh_token.sh ``` The script reads `config/granola_oauth.json`, posts to the token endpoint (`https://mcp-auth.granola.ai/oauth2/token`), and updates both `config/granola_oauth.json` and `config/mcporter.json` with the new access token. Then retry the call. If refresh also fails, the user needs to re-authenticate manually via the OAuth flow above. ## Config Files - `config/granola_oauth.json` — OAuth credentials (client_id, refresh_token, access_token, token_endpoint). **Contains secrets; do not commit.** - `config/mcporter.json` — MCP server config with bearer token header. **Contains secrets; do not commit.**

Frequently asked questions