Notion MCP Server

🚀 Notion MCP サーバー

公式の Notion SDK を提供する Model Context Protocol (MCP) サーバーです。これにより、AI モデルが Notion ワークスペースと相互作用することが可能です。

🚀 クイックスタート

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: 設定 > 高度 > モデルコンテキストプロトコル
• Cursor AI: 設定 > AI > MCP サーバー
• Claude.ai (Web): プロフィール > 設定 > API と統合 > モデルコンテキストプロトコル

✨ 主な機能

このサーバーは、Notion との相互作用に必要なツールを提供します。

• 検索: ページまたはデータベースを検索します。
• データベース: データベースのエントリを照会および取得します。
• ページ: ページの作成、取得、削除を行います。
• ブロック: ページ内のブロックコンテンツを管理します。
• 属性: ページの属性を操作します。

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

📦 インストール

環境変数を使用した設定

.env という名前のファイルを作成し、以下の内容を追加します。

NOTION_API_KEY=your-notion-integration-key

その後、プロジェクトのルートディレクトリで以下のコマンドを実行して設定を適用します。

source .env

📄 ライセンス

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