Notion MCP サーバー

公式の Notion SDK を公開し、AI モデルが Notion ワークスペースと対話できるようにする Model Context Protocol (MCP) サーバー。

クイックスタート

1. Notionの統合を設定する

1. https://www.notion.so/my-integrationsにアクセスしてください。

2. 新しい統合を作成する

3. APIキーをコピーする

2. Notionページを統合に接続する

統合によって Notion コンテンツにアクセスするには、ページまたはデータベースを明示的に共有する必要があります。

1. 統合を通じてアクセスしたいNotionページまたはデータベースに移動します

2. 右上隅の「共有」ボタンをクリックします

3. 「ユーザー、グループ、または統合を追加」フィールドで、ドロップダウンリストから統合を選択します。

4. 「招待」をクリック

5. アクセス可能にしたいページまたはデータベースごとに繰り返します

**注:**統合は、明示的に共有されたページとデータベースにのみアクセスできます。子ページは親ページからアクセスを自動的に継承します。

3. AIアシスタントに追加する

次のいずれかの構成形式を使用して、この MCP サーバーを Claude Desktop、Cursor AI、または Claude.ai に追加できます。

コマンドライン形式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON設定フォーマット

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

your-notion-integration-key手順 1 の API キーに置き換えます。

セットアップ手順

• Claude Desktop ：設定 > 詳細設定 > モデルコンテキストプロトコル

• カーソルAI : 設定 > AI > MCPサーバー

• Claude.ai (Web) : プロフィール > 設定 > APIと統合 > モデルコンテキストプロトコル

Related MCP server: Notion MCP Server

利用可能なツール

サーバーは、Notion と対話するためのツールを提供します。

• 検索: ページまたはデータベースを検索

• データベース: データベースエントリのクエリと取得

• ページ: ページの作成、取得、更新

• ブロック: コンテンツ ブロック (段落、リストなど) を管理します。

• ユーザー: ユーザーを一覧表示し、ユーザー情報を取得する

• コメント: コメントの作成と一覧表示

• リンクプレビュー: URLのリンクプレビューを作成する

代替設定方法

環境変数の使用

API キーを直接渡す代わりに、 .envファイルを使用することもできます。

1. 次の内容で.envファイルを作成します。

NOTION_API_KEY=your-notion-integration-key

2. サーバーを実行します。

npx @ramidecodes/mcp-server-notion@latest -y

環境変数を使用した JSON 構成 (Claude デスクトップ用)

JSON 構成形式で環境変数を使用することもできます。

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

コマンドラインオプション

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

トラブルシューティング

「クライアントの作成に失敗しました」というエラーが発生した場合:

• Windowsでは、npxコマンドの前にcmd /cを使用してください。

• macOS/Linuxでは、npxへのフルパスを使用してみてください。

• AIアシスタントに追加する前に、ターミナルでコマンドをテストしてください

よくある問題

• 「リソースにアクセスできません」エラー: 特定のNotionページまたはデータベースを統合と共有していることを確認してください（手順2を参照）

• 共有メニューに統合が表示されません: ページを更新するか、ブラウザを再起動してください

• 機能が制限されています: Notionの統合設定で適切な機能が有効になっていることを確認してください

特徴

• 公式SDKによる完全なNotion APIサポート

• シームレスなAI統合を実現するMCP準拠

• Notionのあらゆる操作のための包括的なツール

• 詳細なメッセージによる堅牢なエラー処理

• 環境変数による簡単な設定

各ツールの詳細なドキュメントについては、ツールのドキュメントを参照してください。

ライセンス

このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。