---
name: notion-mcp
description: >
  Notion MCP を使って、ユーザーの Notion ワークスペースを操作する。
  ページの検索・取得・作成・更新・移動、データベースの作成・クエリ、コメント管理ができる。
  "Notionで検索", "Notionに書いて", "Notionのページを作って", "Notionのタスクを確認",
  "Notionのデータベースを更新", "Notionにコメント", "Notionを整理" などで使用する。
---

# Notion MCP — ワークスペース操作

Notion 公式リモート MCP サーバー（`https://mcp.notion.com/mcp`）を通じて、ユーザーの Notion ワークスペースにアクセスできる。
ページ・データベース・コメントの読み書きを AI エージェントから直接行える。

## ツール一覧

### 検索・取得

| ツール | 用途 |
|--------|------|
| `notion-search` | ワークスペース全体をキーワード検索。Notion AI プランがあれば Slack・Google Drive・Jira 等の連携ツールも横断検索可能 |
| `notion-fetch` | ページ・データベース・データソースの内容を URL または ID で取得。スキーマやテンプレート情報も含む |

### ページ管理

| ツール | 用途 |
|--------|------|
| `notion-create-pages` | 1つ以上のページを作成。プロパティ・コンテンツの指定、データベーステンプレートの適用が可能。親を省略するとプライベートページになる |
| `notion-update-page` | ページのプロパティやコンテンツを更新。テンプレートの事後適用も可能 |
| `notion-move-pages` | ページやデータベースを別の親に移動 |
| `notion-duplicate-page` | ページを複製（非同期処理） |

### データベース管理

| ツール | 用途 |
|--------|------|
| `notion-create-database` | 新しいデータベースを作成。プロパティ・初期ビューを指定 |
| `notion-update-data-source` | データソースのプロパティ・名前・説明を更新 |
| `notion-query-data-sources` | 複数データソースを横断クエリ。グルーピング・フィルタ・集計に対応（Enterprise + Notion AI 必要） |
| `notion-query-database-view` | データベースの既存ビュー（フィルタ・ソート設定済み）からデータを取得（Business 以上 + Notion AI 必要） |

### コメント

| ツール | 用途 |
|--------|------|
| `notion-create-comment` | ページまたは特定ブロックにコメントを追加。既存ディスカッションへの返信も可能 |
| `notion-get-comments` | ページ上の全コメント・ディスカッションを取得。解決済みスレッドも含む |

### ユーザー・ワークスペース

| ツール | 用途 |
|--------|------|
| `notion-get-teams` | ワークスペース内のチーム（チームスペース）一覧を取得 |
| `notion-get-users` | ワークスペース内の全ユーザー一覧を取得 |
| `notion-get-user` | 特定ユーザーの情報を ID で取得 |
| `notion-get-self` | 自分のボットユーザー情報と接続先ワークスペースの情報を取得 |

## 基本的な使い方

### 情報を探す

```
「先週のミーティングノートを探して」
→ notion-search で検索

「このページの内容を見せて」
→ notion-fetch で URL/ID を指定して取得
```

### ページを作る・更新する

```
「プロジェクトDBに新しいタスクを追加して」
→ notion-fetch でDBのスキーマとテンプレートを確認
→ notion-create-pages でページを作成

「このタスクのステータスを完了に変えて」
→ notion-update-page でプロパティを更新
```

### データベースを操作する

```
「コンテンツカレンダーDBを新規作成して」
→ notion-create-database でプロパティとビューを指定

「今週の自分のタスクを優先度別に見せて」
→ notion-query-data-sources でフィルタ・グルーピング指定
```

### 複合操作のコツ

1. **まず `notion-fetch` でスキーマを確認** — ページ作成・更新前にDBの構造やテンプレートを把握する
2. **`notion-search` で対象を特定** — 操作対象のページ/DBが不明な場合はまず検索する
3. **バッチ操作は `notion-create-pages`** — 複数ページを一度に作成できる

## レート制限

- 全体: 平均 180 リクエスト/分（3 リクエスト/秒）
- 検索: 30 リクエスト/分
- 制限に達した場合は並列操作を減らして再試行する