Notion MCP Server

Notion MCP Server

公式の 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. 右上隅の「Share」ボタンをクリックします
3. 「Add people, groups, or integrations」フィールドで、ドロップダウンリストからインテグレーションを選択します
4. 「Invite」をクリックします
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：Settings > Advanced > Model Context Protocol
• Cursor AI：Settings > AI > MCP Servers
• Claude.ai（Web）：Profile > Settings > API & Integrations > Model Context Protocol

利用可能なツール

このサーバーは Notion を操作するためのツールを提供します。

• 検索：ページまたはデータベースを検索します
• データベース：データベースのエントリをクエリして取得します
• ページ：ページを作成、取得、更新します
• ブロック：コンテンツブロック（段落、リストなど）を管理します
• ユーザー：ユーザーの一覧表示やユーザー情報の取得を行います
• コメント：コメントを作成、一覧表示します
• リンクプレビュー：URL のリンクプレビューを作成します

その他の設定方法

環境変数を使用する

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

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

NOTION_API_KEY=your-notion-integration-key

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

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

環境変数を使った JSON 設定（Claude Desktop 用）

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

トラブルシューティング

「Failed to create client」エラーが発生する場合：

• Windows では、npx コマンドの前に cmd /c を付けてみてください
• macOS/Linux では、npx のフルパスを使用してみてください
• AI アシスタントに追加する前に、ターミナルでコマンドをテストしてください

よくある問題

• 「No access to resource」エラー：対象の Notion ページまたはデータベースをインテグレーションと共有していることを確認してください（手順 2 を参照）
• 共有メニューにインテグレーションが表示されない：ページを更新するか、ブラウザーを再起動してみてください
• 機能が制限されている：Notion のインテグレーション設定で、インテグレーションに適切な機能が有効になっていることを確認してください

機能

• 公式 SDK を通じた Notion API の完全なサポート
• シームレスな AI 統合を実現する MCP 準拠
• Notion のあらゆる操作に対応する包括的なツール
• 詳細なメッセージを含む堅牢なエラー処理
• 環境変数による簡単な設定

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

ライセンス

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