Notion MCP Server

🚀 Notion APIキーと権限の設定

このドキュメントでは、Notion APIキーの作成、ページ権限の設定、コードの更新、Claudeでの設定、Notionライブラリのインストール、およびドキュメント文字列の生成について説明します。

📦 Notion APIキーの作成

1. Notion統合にアクセス

• Notion統合にアクセスし、あなたのNotionアカウントでログインします。

2. 新しい統合を作成

• "New Integration"をクリックし、必要なフィールド（例：統合名）を入力し、接続するワークスペースを選択します。

3. 統合を保存

• 送信するとAPIキーが生成されます。このキーをコピーし、安全に保存してください。これは後続のAPIリクエストの認証に使用されます。

4. APIキーを取得

• 生成されたAPIキーをコピーし、その安全性を確保してください。

📄 統合を使用するためのページ権限の設定

1. Notionページを開く

• 権限を付与するNotionページを開きます。

2. ページを共有

• ページの右上にある "Share" ボタンをクリックします。

3. 統合を招待

• "Invite" テキストボックスに統合名を入力し、ドロップダウンリストから選択します。これにより、統合にページへのアクセス権が付与されます。

4. 権限を設定

• 統合が必要な操作（例：読み取り、書き込み）を実行するための必要な権限を持っていることを確認してください。

💻 コードの更新

notion_sdk.py ファイルで、PAGE_ID を以前に作成したページのIDに更新します。ページのリンクをコピーすることでIDを取得できます。

例のNotionページID

https://www.notion.so/MCP-Parent-Page-1d21f7216bdb80789f88fccd964b5031

Curlの例

以下は、Notion APIを使用して新しいページを作成する例です。

curl --location --request POST 'https://api.notion.com/v1/pages' \
--header 'Authorization: Bearer $NOTION_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Notion-Version: 2021-05-13' \
--data '{
"parent": { "page_id": "1d21f7216bdb80789f88fccd964b5031" },
"properties": {
    "title": [
        {
            "text": {
                "content": "新页面标题"
            }
        }
    ]
}
'

🛠️ Claudeでの設定

uv ツールのインストール

Macを使用している場合は、以下のコマンドでインストールします。

brew install uv

インストールが成功したことを確認します。

uv --version

Pythonスクリプトを実行します。

uv run <script>.py

環境変数の設定

Claudeでは、NOTION_API_KEY を環境変数に追加する必要があります。例えば：

export NOTION_API_KEY=your_api_key_here

または、設定ファイルで実行可能ファイルのパスを指定します。

{
  "executors": {
    "default_python": {
      "command": "/usr/bin/python3",
      "env": {
        "NOTION_API_KEY": "your_api_key"
      }
    }
  }
}

📦 Notionライブラリのインストール

pip を使用して notion-client をインストールします。

pip install notion-client

📖 ドキュメント文字列の生成例

以下は、LLMと人間がツールの使い方とパラメータを理解するのに役立つ関数のドキュメント文字列の例です。

例の関数とそのドキュメント文字列

def get_page_content(page_id: str) -> dict:
    """
    指定されたページの内容を取得します。
    
    Args:
        page_id (str): 内容を取得するページのID
        
    Returns:
        dict: ページの内容（タイトルやその他の属性を含む）
    """
    # 具体的な実装コード

別の例

def create_new_page(parent_id: str, title: str) -> str:
    """
    指定された親ページの下に新しいページを作成します。
    
    Args:
        parent_id (str): 親ページのID
        title (str): 新しいページのタイトル
        
    Returns:
        str: 新しく作成されたページのID
    """
    # 具体的な実装コード

使用上の注意事項

• 概要：関数の目的を簡潔に説明します。
• パラメータ：各入力パラメータの型と用途を詳細に説明します。
• 戻り値：戻り値の型と意味を明確にします。

これらの規則に従うことで、ドキュメント文字列が人間とモデルの両方に使いやすくなります。