Notion MCP サーバー
Notion 統合用のモデル コンテキスト プロトコル サーバー。Claude や他の LLM が Notion ワークスペースと対話できるようになります。
特徴
- Notionを検索: Notionワークスペース全体を検索
- ページの取得: 特定のNotionページからコンテンツを取得する
- ページを作成: Notionワークスペースに新しいページを作成します
- ページの更新: 既存のページを新しいコンテンツまたはタイトルで更新します
- データベースの作成: カスタムプロパティを使用して新しいデータベースを作成します
- データベースのクエリ: フィルターと並べ替えを使用してデータベースをクエリします
- データベースエントリの更新: データベースエントリのプロパティを更新します
- データベース行の作成: カスタムプロパティを使用して既存のデータベースに新しい行を追加します
設定
- このリポジトリをクローンする
- 依存関係をインストールする
- Notion APIキーを設定する
- Notion開発者ポータルで統合を作成する
- APIキーをコピーする
- 次のいずれかを実行できます。
.envファイルを編集し、 your_notion_api_key_here実際のAPIキーに置き換えます。- Claude for Desktop 構成に直接渡します (推奨、下記参照)
- サーバーを構築する
- サーバーの実行
Claude for Desktop の設定
- Claude for Desktop をインストールします（まだインストールされていない場合）
- Claude for Desktop App の構成を開きます。
- macOSの場合:
~/Library/Application Support/Claude/claude_desktop_config.json - ファイルが存在しない場合は作成する
- Notion サーバーを設定に追加します。
{
"mcpServers": {
"notion": {
"command": "node",
"args": [
"/Users/shaheerahmad/Documents/notion-mcp-server/dist/index.js",
"--notion-api-key=YOUR_ACTUAL_API_KEY_HERE"
]
}
}
}
/Users/shaheerahmad/Documents/notion-mcp-serverプロジェクトディレクトリへのフルパスを入力します。YOUR_ACTUAL_API_KEY_HEREを実際の Notion API キーに置き換えます
- デスクトップ版のClaudeを再起動する
サーバーの使用
Claude for Desktop に接続すると、次のような質問をしてサーバーを使用できるようになります。
- 「Notionワークスペースで会議メモを検索する」
- 「プロジェクト計画ページの内容を取得する」（ページIDが必要です）
- 「Notionでタスクリストを含む新しいページを作成する」
- 「ID 1aaada269d1b8003adceda69cf7bcd97 の Notion ページを、「ページに追加する新しいコンテンツがあります。」というコンテンツで更新します。」
- 「NotionページにID 1aaada269d1b8003adceda69cf7bcd97で新しいデータベースを作成します」
- 「ID 1aaada269d1b8003adceda69cf7bcd97 の Notion データベースで、ステータスが「完了」のアイテムをクエリします。」
Claude はあなたのリクエストに基づいて適切なツールを自動的に使用します。
ツールの使用例
Notionを検索
Search for "meeting notes" in my Notion workspace
ページコンテンツを取得
Get the content of my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97
新しいページを作成する
Create a new page in Notion with title "Weekly Report" and content "This week we accomplished the following tasks..."
既存のページを更新する
Update my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with content "Adding this new information to the page."
タイトルを更新することもできます。
Update my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with title "New Title" and content "New content to add."
新しいデータベースを作成する
Create a new database in my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with title "Task Tracker" and properties {
"Task Name": { "title": {} },
"Status": {
"select": {
"options": [
{ "name": "Not Started", "color": "red" },
{ "name": "In Progress", "color": "yellow" },
{ "name": "Completed", "color": "green" }
]
}
},
"Priority": {
"select": {
"options": [
{ "name": "Low", "color": "blue" },
{ "name": "Medium", "color": "yellow" },
{ "name": "High", "color": "red" }
]
}
},
"Due Date": { "date": {} }
}
データベースのクエリ
Query my Notion database with ID 1aaada269d1b8003adceda69cf7bcd97 with filter {
"property": "Status",
"select": {
"equals": "Completed"
}
}
並べ替えを追加することもできます。
Query my Notion database with ID 1aaada269d1b8003adceda69cf7bcd97 with sort {
"property": "Due Date",
"direction": "ascending"
}
データベースエントリの更新
既存のデータベース エントリ (データベース内のページ) のプロパティを更新します。
{
"tool_name": "update-database-entry",
"tool_params": {
"pageId": "page_id_of_database_entry",
"properties": {
"Status": {
"select": {
"name": "Completed"
}
},
"Priority": {
"select": {
"name": "High"
}
},
"Due Date": {
"date": {
"start": "2023-12-31"
}
}
}
}
}
propertiesパラメータは、データベース内の特定のプロパティタイプに対してNotion APIが期待する構造と一致する必要があります。プロパティタイプ（テキスト、選択、日付など）によって必要なフォーマットが異なります。
データベース行の作成
カスタム プロパティを使用して既存のデータベースに新しい行を追加します。
{
"tool_name": "create-database-row",
"tool_params": {
"databaseId": "your_database_id_here",
"properties": {
"Name": {
"title": [
{
"text": {
"content": "New Task"
}
}
]
},
"Status": {
"select": {
"name": "Not Started"
}
},
"Priority": {
"select": {
"name": "Medium"
}
},
"Due Date": {
"date": {
"start": "2023-12-15"
}
},
"Notes": {
"rich_text": [
{
"text": {
"content": "This is a new task created via the API"
}
}
]
}
}
}
}
propertiesパラメータには、データベースに必要なすべてのプロパティを含める必要があり、各プロパティ タイプの Notion API 構造に従う必要があります。
トラブルシューティング
- ツールが表示されない場合は、Claude for Desktop のログを確認してください。
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
- Notion API キーが正しく設定されており、統合により対話するページへのアクセスが許可されていることを確認してください。
- ログに「予期しないトークン」エラーが表示される場合、console.log ステートメントが MCP プロトコルに干渉している可能性があります。このバージョンのサーバーは、これらの問題を回避するために更新されています。
今後の改善
- データベースクエリ機能を追加する
- コンテンツのフォーマットを改善する
- より多くのブロックタイプのサポートを追加