生産性初級

Claude Code × Notion

Notion

MCP設定

~/.claude/claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-server-notion"
      ],
      "env": {
        "NOTION_API_KEY": "ntn_your-api-key-here"
      }
    }
  }
}

できること

ページ作成・編集

Notionページの新規作成や既存ページのコンテンツ編集。見出し・リスト・コードブロックなどリッチテキスト形式に対応。

データベース操作

Notionデータベースへのレコード追加・更新・フィルタリング・ソート。プロパティの型に応じた値の設定が可能。

ブロック管理

ページ内のブロック（段落、画像、埋め込みなど）の追加・削除・並び替え。

検索

ワークスペース全体からキーワードやフィルタ条件でページ・データベースを横断検索。

活用シーン

議事録自動作成

会議の音声テキストやチャットログを入力として、構造化された議事録（参加者・議題・決定事項・TODO）をNotionページに自動生成。

プロジェクト管理

GitHubのIssueやPRの状況をNotionデータベースに同期し、進捗ダッシュボードを自動更新。

ドキュメント生成

コードベースからAPI仕様書や設計ドキュメントを自動生成し、Notionの技術ドキュメントスペースに整理して保存。

前提条件

Notionアカウント
Notion Integration（API Key）の作成
対象ページ・データベースへのIntegration接続設定
Claude Codeインストール済み

トラブルシューティング

APIキーで認証エラーが出る

Notion Integrationが正しく作成されているか確認してください。Settings & members → Integrations → Develop or manage integrationsからキーを再取得できます。

ページやデータベースが見つからない

対象のページ・データベースにIntegrationが接続されているか確認してください。ページ右上の「...」→「接続」からIntegrationを追加する必要があります。

ブロックの書き込みに失敗する

Notion APIのブロックサイズ制限（1リクエストあたり最大100ブロック）を超えている可能性があります。大きなコンテンツは複数回に分けて書き込んでください。