mcp-granola

GranolaのミーティングノートにAIエージェントがアクセスできるようにするMCP (Model Context Protocol)サーバーです。ノートの検索、AI要約やトランスクリプトを含む全コンテンツの取得、ミーティング履歴のページネーションが可能です。

機能

• ノートの一覧表示: 日付フィルタリングとカーソルベースのページネーションに対応

• ノートの全コンテンツ取得: AI要約やミーティングのトランスクリプトを含む詳細を取得

• ノートの検索: タイトルや要約のキーワードで検索

• 互換性: Claude Code、Gemini CLI、およびMCP互換クライアントで動作

• 依存関係: MCP SDK以外の外部依存関係はゼロ

クイックスタート

1. インストール

npm install @devli13/mcp-granola

または、クローンしてローカルでインストールします：

git clone https://github.com/devli13/mcp-granola.git
cd mcp-granola
npm install

2. Granola APIキーの取得

1. Granolaデスクトップアプリを開く

2. Settings > API に移動

3. Create new key をクリック

4. キーをコピーする（grn_で始まります）

3. 設定

.mcp.json (Claude Code) または .gemini/settings.json (Gemini CLI) に追加します：

{
  "mcpServers": {
    "granola": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-granola"],
      "env": {
        "GRANOLA_API_KEY": "grn_your_api_key_here"
      }
    }
  }
}

または、直接実行します：

GRANOLA_API_KEY=grn_your_key node server.js

設定

ツール

例: 最近のノートを一覧表示

{
  "name": "list_notes",
  "arguments": {
    "limit": 5,
    "created_after": "2025-01-01T00:00:00Z"
  }
}

例: トランスクリプト付きでノートを取得

{
  "name": "get_note",
  "arguments": {
    "id": "not_abc123def456",
    "include_transcript": true
  }
}

制限事項

• Granola APIはベータ版です — エンドポイントやレスポンスの形式が変更される可能性があります。

• 個人用APIキーは、自分が所有しているノート、または直接共有されたノートのみにアクセスできます。

• **search_notes**は、最新の200件のノートに対してクライアントサイドで部分一致検索を行います。全文検索エンジンではありません。ノートの数が多い場合は、日付フィルタを指定したlist_notesを使用してください。

• APIは、AI要約とトランスクリプトが生成されたノートのみを返します。処理中のノートは表示されません。

レート制限

Granolaはワークスペースごとにレート制限を設けています：

コントリビューション

Issueやプルリクエストを歓迎します！大幅な変更を行う前に、まずはIssueを作成して議論してください。

ライセンス

MIT