Granola Plugin

Access your Granola.ai meeting notes, transcripts, and recordings through OpenPets. Search meetings, retrieve transcripts, and query your meeting data using natural language via Granola's official MCP server.

Features

• Query Meetings - Ask conversational questions about your meetings
• List Meetings - Browse recent meetings with details
• Search Content - Find specific meetings by keywords or topics
• Get Transcripts - Access raw meeting transcripts (paid tiers only)
• OAuth Authentication - Secure browser-based authentication (no API keys!)

Quick Start

1. No Configuration Required!

Unlike most plugins, Granola uses OAuth authentication. No environment variables or API keys needed!

2. Test the Plugin

cd pets/granola
opencode run "list my recent meetings from Granola" --print-logs

On first use, a browser window will open automatically for OAuth authentication.

3. Example Queries

# List recent meetings
opencode run "list my recent meetings from Granola"

# Search for specific topics
opencode run "search Granola meetings about project planning"

# Ask conversational questions
opencode run "what did we discuss in yesterday's standup?"

# Get transcript (paid tiers only)
opencode run "show me the transcript from my last meeting"

Authentication

Granola uses OAuth 2.0 authentication via browser popup:

1. Run any Granola query
2. Browser opens automatically to authenticate
3. Authorize the OpenPets integration
4. Return to your terminal - you're connected!

No API keys, no environment variables, no hassle.

Available Tools

| Tool | Description | |------|-------------| | granola-test-connection | Check plugin status and configuration | | granola-query-meetings | Ask conversational questions about meetings | | granola-list-meetings | Browse meetings with ID, title, date, attendees | | granola-get-meetings | Search meetings by content or keywords | | granola-get-transcript | Access raw meeting transcripts (paid only) |

Requirements

Granola Account

• Free Plan: Query notes from last 30 days
• Paid Plan: Full history access + transcript retrieval
• Rate Limit: ~100 requests per minute

Supported AI Tools

• Claude (paid plans)
• ChatGPT (Plus/Pro/Business/Enterprise)
• OpenCode (all plans)

Limitations

• Only meetings you own are accessible (shared meetings excluded)
• Transcripts require paid Granola subscription
• Basic plan limited to 30 days of history
• OAuth authentication requires browser access

Example Workflows

Search and Review

# Find relevant meetings
opencode run "search Granola meetings about quarterly review"

# Get details
opencode run "show me details for meeting ID abc123"

# Read transcript
opencode run "get the transcript from that meeting"

Daily Standup Review

opencode run "what topics came up in today's standup meeting?"

Weekly Summary

opencode run "list all my meetings from this week and summarize key decisions"

Troubleshooting

"Unauthorized" Error

Solution: Re-authenticate by running any query. Browser will open for OAuth.

"No meetings found"

Check:

• You have meetings in your Granola account
• Your account has access (Basic = last 30 days only)
• Meetings are owned by you (not just shared to you)

OAuth popup blocked

Solution:

1. Allow popups in your browser for localhost
2. Run query again to retry authentication

Rate limit exceeded

Solution: Wait a few moments. Rate limit is ~100 requests/minute.

Testing

# Run test scenarios
bun test:pet granola --query "list my recent meetings from Granola"

# With follow-ups
bun test:pet granola \
  --query "list my recent meetings" \
  --follow "search for meetings about planning" \
  --follow "what decisions were made?"

# Interactive mode
bun test:pet granola --interactive

Development

Project Structure

pets/granola/
├── index.ts           # Main plugin entry
├── mcp.ts             # MCP tool definitions
├── package.json       # Plugin configuration
├── opencode.json      # OpenCode loader config
├── README.md          # This file
└── .env.example       # Environment template (empty for OAuth)

Adding Custom Tools

To extend with custom logic:

// index.ts
import mcpTools from "./mcp"

const customTools: ToolDefinition[] = [
  {
    name: "granola-custom-action",
    description: "Your custom tool",
    schema: z.object({ /* ... */ }),
    async execute(args) {
      // Your logic
    }
  }
]

return createPlugin([
  testConnectionTool,
  ...customTools,
  ...mcpTools
])

Debugging

Enable debug logs:

export DEBUG=openpets:granola
opencode run "your query" --print-logs

Documentation

• Granola MCP Documentation
• Granola API Docs
• Granola Homepage

FAQ

Do I need an API key?

No! Granola uses OAuth authentication via browser. No API keys or environment variables required.

Can I access shared meetings?

No, only meetings you own are accessible through the MCP server.

What's included in the free plan?

Basic plan gives you 30 days of meeting history. Transcripts require a paid subscription.

How do I authenticate?

Just run any query. A browser window will open automatically for OAuth authentication.

Can I revoke access?

Yes, go to your Granola account settings to manage connected applications.

Support

• Issues: OpenPets GitHub
• Granola Support: [email protected]
• Documentation: docs.granola.ai

License

MIT - See LICENSE for details.