6
11

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Notion × MCP × Claude Codeで『非エンジニアのタスク管理』を自動化する ― 議事録からチケット生成、進捗レポートまで全自動ワークフロー構築ガイド

6
Posted at

結論:週3時間の定型作業がゼロになります

毎週の議事録整理とチケット起票、進捗レポート作成に何時間かけていますか?――Notion × MCP × Claude Codeの3点連携で、その作業をゼロにした方法を手順付きで解説します。

この記事を読むと、以下ができるようになります。

  • 議事録テキストを渡すだけでNotionにチケットが自動生成される
  • 週次進捗レポートがNotionのDBから自動集計・Slack通知される
  • 非エンジニアが抱えていた定型タスクのボトルネックが解消される

実際にチームに導入した結果、PM・ディレクター職のメンバーが週あたり約3時間の作業削減を実現しました。


課題:非エンジニアの定型タスクがボトルネックになっている

多くの開発チームで、こんな光景が繰り返されていないでしょうか。

  1. 会議後:議事録をNotionに整理する(30分)
  2. チケット起票:議事録からTODOを抽出してNotionのタスクDBに手入力する(30分)
  3. 週次レポート:Notionのタスク状況を集計してSlackに報告する(30分)

これらはいずれも「判断」よりも「転記・整形」が大半を占める作業です。にもかかわらず、PM・ディレクターの貴重な時間を毎週奪い続けています。

本質的な問題は、「Notionのデータを読み書きする手段」と「自然言語を構造化する能力」が分断されていたことです。MCPとClaude Codeがこの分断を埋めます。


アーキテクチャ全体像

まず全体のデータフローを把握しましょう。

構成要素は3つだけです。

コンポーネント 役割
Notion データベース(議事録・タスク・レポート)
Notion MCP Server Claude CodeとNotion APIのブリッジ
Claude Code 自然言語理解・構造化・実行エージェント

環境・前提条件

  • Claude Code CLI がインストール済み(claude コマンドが使える状態)
  • Node.js 18以上
  • Notionアカウント(無料プランでもOK)
  • Slack Webhook URL(レポート通知用。任意)

Step 1:Notion MCP Serverのセットアップと認証設定

1-1. Notionインテグレーションの作成

  1. Notion Developers にアクセス
  2. 「New integration」でインテグレーションを作成
  3. Internal Integration Token を控える
  4. 対象のNotionページ/DBで「コネクト」からこのインテグレーションを追加

重要:インテグレーションを追加し忘れると、APIからDBが見えません。これが最も多いハマりポイントです。

1-2. MCP Serverの設定

Claude Codeの設定ファイル(~/.claude/claude_code_config.json もしくはプロジェクトルートの .mcp.json)にNotion MCP Serverを追加します。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "ntn_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

補足:公式の @notionhq/notion-mcp-server パッケージを使用します。コミュニティ製のMCPサーバーも複数存在しますが、公式版が最も安定しています。2025年7月時点の情報です。

1-3. 接続確認

Claude Codeを起動して、MCP接続を確認します。

claude

起動後、以下のように問いかけます。

Notion MCPサーバーに接続できているか確認して、利用可能なツール一覧を表示してください。

notion_search、notion_create_page、notion_query_database などのツールが表示されれば成功です。


Step 2:Claude CodeからNotion DBを読み書きするプロンプト設計

MCP経由でNotionを操作するには、Claude Codeに「何をどう操作するか」を的確に伝えるプロンプト設計が鍵です。

2-1. タスクDBのスキーマを把握させる

まず、対象のNotionデータベースの構造をClaude Codeに理解させます。

NotionのデータベースID「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx」の
スキーマ(プロパティ名・型・選択肢)を取得して一覧表示してください。

出力例:

プロパティ名 型 選択肢
タスク名 title -
ステータス select 未着手 / 進行中 / 完了
担当者 people -
期限 date -
優先度 select 高 / 中 / 低
カテゴリ multi_select 開発 / デザイン / 企画

2-2. CLAUDE.md にルールを記述する

プロジェクトルートの CLAUDE.md に、Notion操作時のルールを明記しておくと精度が安定します。

## Notion操作ルール

- タスクDBのID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- 議事録DBのID: yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
- ステータスの初期値: 「未着手」
- 期限が明示されていない場合: 1週間後を設定
- 優先度が明示されていない場合: 「中」を設定
- 担当者はNotion上の表示名で指定する

Step 3:議事録テキスト → 構造化 → Notionチケット自動生成

ここがこのワークフローの核心部分です。

3-1. 処理フロー

3-2. 実行プロンプト

Claude Codeで以下のようにプロンプトを実行します。

以下の議事録テキストを処理してください。

## 処理内容
1. 議事録を構造化して、議事録DBに新規ページとして保存
2. 議事録からアクションアイテム(TODO)を抽出
3. 各アクションアイテムをタスクDBにチケットとして作成
4. 作成したチケットの一覧を表示

## 議事録テキスト
---
2025/07/10 プロジェクト定例

参加者:田中、佐藤、鈴木

■ 進捗報告
- LP制作:デザインカンプ完了。コーディングは佐藤が7/17までに対応
- API連携:認証周りで問題発生中。田中が7/14までに調査

■ 決定事項
- リリース日を7/25に確定
- テスト環境は鈴木が7/15までに準備

■ 次回アジェンダ
- テスト計画のレビュー
---

3-3. Claude Codeが実行すること

Claude Codeは上記プロンプトから以下を自動実行します。

  1. 議事録の構造化:日時・参加者・議題・決定事項をパース
  2. アクションアイテム抽出:「誰が」「何を」「いつまでに」を特定
  3. MCP経由でNotion API呼び出し:notion_create_page ツールで各チケットを作成

実際に生成されるチケットの例:

タスク名 担当者 期限 優先度 ステータス
LPコーディング対応 佐藤 2025/07/17 中 未着手
API認証問題の調査 田中 2025/07/14 高 未着手
テスト環境の準備 鈴木 2025/07/15 中 未着手

3-4. カスタムSlashコマンドで定型化する

毎回プロンプトを書くのは面倒なので、.claude/commands/create-tickets.md にカスタムコマンドとして保存します。

以下の議事録テキストを処理してください。

1. 議事録を構造化して議事録DB($MEETING_DB_ID)に保存
2. アクションアイテムを抽出してタスクDB($TASK_DB_ID)にチケット作成
3. 担当者・期限・優先度はテキストから推定(不明な場合はCLAUDE.mdのデフォルト値を使用)
4. 作成結果を一覧表で報告

## 議事録テキスト
$ARGUMENTS

以降は /create-tickets <議事録テキスト> だけで実行できます。


Step 4:週次進捗レポートの自動生成とSlack通知連携

4-1. レポート生成フロー

4-2. レポート生成プロンプト

こちらも .claude/commands/weekly-report.md として保存しておきます。

週次進捗レポートを生成してください。

## 手順
1. タスクDB($TASK_DB_ID)から全タスクを取得
2. 以下の観点で集計:
   - ステータス別のタスク数(未着手/進行中/完了)
   - 今週完了したタスク一覧
   - 期限超過タスク一覧(担当者名付き)
   - 担当者別の進捗率
3. 集計結果をMarkdown形式のレポートにまとめる
4. Slack Webhook($SLACK_WEBHOOK_URL)にレポートを投稿する

4-3. Slack通知の実装

Claude CodeからSlackへの通知は、curl コマンドを使ったシンプルなWebhook連携で実現できます。Claude Codeはシェルコマンドを実行できるため、特別なライブラリは不要です。

curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"📊 週次進捗レポート\n\n完了: 8件\n進行中: 5件\n未着手: 3件\n⚠️ 期限超過: 2件"}' \
  $SLACK_WEBHOOK_URL

Claude Codeが集計結果をもとにこのコマンドを自動生成・実行してくれます。

定期実行について:cronやGitHub Actionsから claude -p "$(cat weekly-report-prompt.md)" を実行すれば、完全自動化も可能です。ただし、Claude Codeのヘッドレスモード実行にはAPIキーの設定が必要です。


ハマりポイントと解決策3選

1. 認証エラー:401 Unauthorized

原因:Notionインテグレーションが対象ページに接続されていない

解決策:

  • 対象のデータベース(またはその親ページ)を開く
  • 右上の「…」→「コネクト」→ 作成したインテグレーションを追加
  • 子ページには自動で権限が継承されない場合があるため、DB単体でも確認する

2. DBスキーマ不整合:プロパティ名の揺れ

原因:プロンプトで「ステータス」と書いたが、Notion上は「Status」だった

解決策:

  • Step 2で示した通り、最初にスキーマを取得して CLAUDE.md に正確に記載する
  • プロパティ名は完全一致が必要(大文字小文字、全角半角も区別される)
  • 日本語と英語が混在している場合は、Notion側で統一するのがベスト

3. トークン上限:大量タスクの一括処理で途中停止

原因:Notion DBのレコード数が多い場合、レスポンスが巨大になりコンテキストウィンドウを圧迫する

解決策:

  • フィルタ条件を指定して取得件数を絞る(例:直近2週間のタスクのみ)
  • CLAUDE.md に「DBクエリ時は必ず日付フィルタを付与すること」と記載
  • それでも厳しい場合は、取得→集計を分割して段階的に処理するようプロンプトで指示する

運用コストと効果

導入前 vs 導入後

作業 導入前(手動) 導入後(自動) 削減時間/週
議事録整理 30分 × 2回 約2分 × 2回 56分
チケット起票 30分 × 2回 自動(0分) 60分
週次レポート作成 45分 × 1回 約3分 × 1回 42分
合計 約2時間45分 約7分 約2時間38分

実測値はチームの規模(5〜8名)・週2回の定例ミーティングを前提としています。議事録のボリュームやタスク数によって変動します。

ランニングコスト

  • Claude Code:Claude Proプラン(月額$20)またはAPI従量課金
  • Notion:無料プランでもAPI利用可能(チーム利用はPlusプラン推奨)
  • MCP Server:ローカル実行のため追加コストなし

週3時間 × 時給換算で考えれば、初月から十分にペイする投資です。


まとめ

  • Notion MCP Server により、Claude CodeからNotionのデータベースを直接読み書きできる。セットアップは設定ファイル1つで完了する
  • 議事録テキストを貼るだけで、タスク抽出・チケット作成・進捗レポート生成まで全自動化できる。カスタムSlashコマンドで定型化すれば、非エンジニアでも運用可能
  • ハマりポイントは「認証の接続忘れ」「プロパティ名の不一致」「トークン上限」の3つ。いずれも事前にCLAUDE.mdでルールを明記しておくことで回避できる

参考リンク

6
11
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
6
11

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?