my_pm_tools
Manages GitHub Projects V2, issues, pull requests, statuses, priorities, and sprints via gh CLI and GraphQL API.
Integrates with Google Workspace APIs (Calendar, Sheets, etc.) for bi-directional data synchronization.
Supports migration from Jira by importing CSV exports into GitHub Projects.
Supports migration from Linear by importing CSV exports into GitHub Projects.
Reads and writes Notion databases and pages for project management integration.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@my_pm_toolscreate a new issue for the login page bug"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
My PM Tools
English · v5.4.0 — AI 時代の PM Operator Stance 搭載
GitHub Projects V2 の PM 支援スキル。環境構築・日常運用・Sprint 分析・移行を統合サポート。「Issue を作成して」「ステータスを変更」「Sprint レポート出して」等の自然言語で gh CLI + GraphQL + Notion + Google Workspace を束ねて実行します。
31 MCP ツール / 9 shell scripts / 536 tests / 6 references docs (12 principles + 30 anti-patterns + Cynefin + Premortem + Spec Quality Gate + CALM self-evaluation)
Product Vision
JTBD: PM が GitHub Projects V2 の管理と Notion・Google Workspace の読み書きを自然言語で即実行する
Field | Definition |
Target User | 個人〜小規模チーム(1-10人)の PM / テックリード。特に並行 AI コーディングエージェントを束ねる PM。 |
Core Value | GraphQL API + Notion API + Google APIs の複雑さを吸収し、CLI で完結。外部ドキュメント・スプレッドシート・カレンダーの双方向連携 |
Scope | Mode A(Setup), Mode B(Daily Ops), Mode C(Analytics), Migration, Workspace Bridge(Read+Write), PM Operator Stance |
Non-Goals | GUI構築, マルチOrg対応, Slack連携自前実装, Jira/Linear完全代替, Gmail送信 |
Suite内の位置づけ: requirements_designer → speckit-bridge → **my_pm_tools** → pm-data-analysis。仕様が固まった後の実行管理レイヤー。
🛡️ PM Operator Stance — AI 時代の PM 自己規律(12 原則 / v5.4.0)
並行 AI コーディングエージェント(Claude Code / Cursor / Devin / Aider 等)を束ねる運用では、PM の役割は「ロードマップ責任者」よりも 最後の砦としての coordinator(インシデントコマンダーに近い) に寄ります。Multi-Agent System Taxonomy (MAST, UC Berkeley 2025) は multi-agent failures のうち 41.77% が spec 層、36.94% が coordination 層、21.30% が verification 層 で起きると報告しています。古典 PM 正典は必要だが、この 3 層攻略には不十分です。
12 原則は Amazon / Google SRE / DORA / Cagan / Perri / Torres / Klein / Snowden / Taleb / Meadows / Anthropic / MAST / CALM 等 200+ 文献の統合から導出され、各原則が (a) 出典 / (b) 適用しない条件 (reversal) / (c) 測定方法 を持ちます。reversal 無き原則はドグマ。
12 原則(要約 — 詳細は SKILL.md 「PM Operator Stance」章、および references/)
# | 原則 | 主な attack 先 |
P1 | Outcomes over outputs | velocity 盲信 |
P2 | Cynefin-aware routing | 過剰/過小エンジニアリング |
P3 | Chain-of-Verification over self-report trust | MAST verification layer |
P4 | Premortem before commit | 盲点リスク |
P5 | Blameless postmortem + Just Culture | 再発・second victim |
P6 | Working Backwards artifact as SSOT | MAST spec layer / prompt bloat |
P7 | Error Budget / SLO-first | over-shipping / freeze discipline |
P8 | Trunk-Based + small PRs + fast CI | merge race / long branches |
P9 | Leverage-point prioritization | parameter 癒着修正 |
P10 | Antifragile posture, convex bets | irreversible risk |
P11 | Continuous Discovery (human cadence) | AI が delivery 加速→ discovery 枯渇 |
P12 | LNO triage + CALM bias audit | PM 自身の 12 認知バイアス |
関連ドキュメント(references/)
references/ai-pm-principles-research.md— 論文本体(Part 1-9 + 40+ 引用)references/anti-patterns.md— 30 アンチパターン watchlist(spec/coordination/verification/cognitive/process)references/cynefin-guide.md— 5 ドメイン判別と orchestration マッピングreferences/premortem-template.md— 5 分ルーチン + Devil's Advocatereferences/spec-quality-gate.md— 5 項目 Boolean ゲートreferences/self-evaluation-protocol.md— CALM 12 バイアス checklist + Reflexion 儀式
Non-destructive upgrade note
v5.3.0 の 7 原則は 精神的に保存 され、12 原則に包摂されています。7 原則を既に内面化していれば、12 原則は同じ理念に citation / reversal / measurement を追加したもので、リセットではありません。詳細は SKILL.md の「Non-destructive upgrade note」参照。
3つのモード
モード | 用途 | 主な操作 |
Mode A: 環境構築 | 新規プロジェクトのセットアップ | 14ステータス・5ビュー・13ラベル・テンプレート・ワークフロー一括構築 |
Mode B: 日常運用 ★ | Issue/PR 作成、ステータス変更、バックログ管理 |
|
Mode C: 分析 | Sprint レポート、ベロシティ追跡 |
|
Lite モード(小〜中規模チーム向け)
--lite フラグで、1-3人チーム向けの簡素構成を構築できます:
./scripts/setup-all.sh <OWNER/REPO> <PROJECT_NUMBER> --lite構成 | ステータス | ビュー | ラベル | 推奨チーム規模 |
Lite | 8 | 3 | 5 | 1-3人 |
Full (デフォルト) | 14 | 5 | 13 | 4人以上 |
Lite → Full への移行はいつでも可能(setup-all.sh を --lite なしで再実行)。
初回起動時にプロジェクト状態を自動検出し、未構築なら Mode A、構築済みなら Mode B で起動します。プロジェクト情報は .github-project-config.json に保存され、2回目以降は即座に操作可能です。
前提条件
ghCLI がインストール済み&認証済みGitHub Classic PAT(
ghp_トークン)— Fine-grained PAT は Projects V2 GraphQL API 非対応PAT スコープ:
project,repo,read:org
インストール
git clone git@github.com:fideguch/my_pm_tools.git
cd my_pm_tools
./install.sh # ~/.claude/skills/my_pm_tools/ にインストールClaude Code または Devin で以下のように起動:
「Issue を作成して」「プロジェクト環境を構築して」「Sprint レポートを出して」クイックスタート
新規プロジェクト構築(Mode A)
./scripts/setup-all.sh <OWNER/REPO> <PROJECT_NUMBER>日常運用(Mode B)
# Issue/PR をプロジェクトに追加
./scripts/project-ops.sh <OWNER> <NUMBER> add-issue <REPO> <ISSUE_NUM>
./scripts/project-ops.sh <OWNER> <NUMBER> add-pr <REPO> <PR_NUM>
# ステータス変更(カード移動)
./scripts/project-ops.sh <OWNER> <NUMBER> move <ITEM_ID> "開発中"
# Priority 設定
./scripts/project-ops.sh <OWNER> <NUMBER> set-priority <ITEM_ID> P1
# アイテム一覧
./scripts/project-ops.sh <OWNER> <NUMBER> list-items分析・レポート(Mode C)
./scripts/sprint-report.sh <OWNER> <NUMBER> # 現在の Sprint
./scripts/sprint-report.sh <OWNER> <NUMBER> --sprint previous # 前回の Sprint
./scripts/sprint-report.sh <OWNER> <NUMBER> --sprint "Sprint 3" # タイトルで指定
./scripts/sprint-report.sh <OWNER> <NUMBER> --json # JSON 出力MCP Server 経由の場合も
sprintパラメータでcurrent/previous/ Sprint タイトルを指定可能。200+ アイテムのプロジェクトはカーソルページネーション(最大20ページ)で全件取得。
他ツールからの移行
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format jira # Jira
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format linear # Linear
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format notion # Notion
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> tasks.csv --dry-run # プレビュー構築される環境
要素 | 内容 |
ステータス | 14段階(Icebox → Planning → Design → Dev → Release → Done) |
ビュー | 5種(Product Backlog, Sprint Board, Sprint Table, Roadmap, My Items) |
カスタムフィールド | Priority (P0-P4), Sprint (1w Iteration), Estimate (Number), Target (Text) |
ラベル | 13種(Type 6 + Area 4 + Ops 3) |
テンプレート | Issue (feature/bug) + PR テンプレート |
自動化 | Built-in Workflows 5 + GitHub Actions 5 |
スクリプト一覧
スクリプト | モード | 用途 |
| A | 全環境一括構築 |
| A | ラベル13種一括作成 |
| A | カスタムフィールド作成 |
| A | Status 14オプション設定 |
| A | 5ビュー作成(Lite: 3ビュー) |
| A | テンプレート&ワークフロー自動配置 |
| B | Issue/PR追加・ステータス変更・Priority設定 |
| A | Jira/Linear/Notion CSV 移行 |
| C | Sprint レポート(ベロシティ・完了率) |
MCP Server
AI エージェント(Claude Code, GitHub Copilot 等)から MCP 経由でプロジェクト操作を実行できます。
セットアップ
npm install && npm run buildClaude Desktop の設定 (~/.claude/settings.json または MCP 設定):
{
"mcpServers": {
"my_pm_tools": {
"command": "node",
"args": ["/path/to/my_pm_tools/dist/index.js"],
"env": { "GITHUB_TOKEN": "ghp_..." }
}
}
}MCP ツール一覧
ツール | 方式 | 説明 |
| GraphQL | フィールド・オプション一覧 |
| GraphQL | アイテム一覧(ステータス/優先度フィルタ対応、ページネーション) |
| GraphQL | Issue/PR をプロジェクトに追加 |
| GraphQL | ステータス変更(別名対応: "dev"→"開発中") |
| GraphQL | 優先度設定(P0-P4) |
| GraphQL | Sprint レポート生成 |
| GraphQL | Issue 詳細取得(タイトル、本文、ラベル、アサイン、マイルストーン) |
| gh CLI | Issue 新規作成(日本語タイトル・本文対応) |
| gh CLI | Issue のタイトル・本文を編集 |
| gh CLI | Issue のラベル追加・削除 |
| gh CLI | Issue のアサイン追加・削除 |
| gh CLI | Issue のクローズ・リオープン |
| Notion API | Notionページ・DB検索 |
| Notion API | ページ内容取得(Markdown変換) |
| Notion API | データベースクエリ(フィルタ・ソート) |
| Notion API | ページ作成 |
| Notion API | ブロック追記 |
| Drive API | Driveファイル検索 |
| Drive API | Googleドキュメント取得(Markdown) |
| Sheets API | スプレッドシートデータ取得 |
| Drive API | スライド取得(テキスト) |
| Calendar API | カレンダーイベント取得 |
| Gmail API | メール検索 |
| Sheets API | スプレッドシートセル書き込み |
| Sheets API | スプレッドシート行追加 |
| Calendar API | カレンダーイベント作成 |
| Notion API | ページプロパティ更新 |
| Notion API | ページアーカイブ(削除) |
| gh CLI + grep/git | ゾンビIssue検出(実装済みだがOpenのままのIssue候補を証拠付きで提示) |
| gh CLI + grep | コード内TODO/FIXME/HACK/XXXを収集し、Issue化を提案 |
| gh CLI + grep/git | バックログ健全性スコア(0-100)とレポート生成 |
ステータス別名(11種): 英語の省略形で日本語ステータスを操作可能。
Alias | 解決先 | Alias | 解決先 | |
| 開発中 |
| テスト中 | |
| コードレビュー |
| Done | |
| Backlog |
| Icebox | |
| テスト落ち |
| リリース済み | |
| 進行待ち |
| デザイン作成中 | |
| 開発待ち |
解決順序: 完全一致 → エイリアス一致 → 部分一致(大文字小文字無視)。
ドキュメント
ドキュメント | 内容 |
日常運用・ビュー・Sprint・移行・FAQ | |
14ステータスの詳細仕様 | |
5ビューの設定仕様 | |
ワークフロー・スクリプトの設定手順 | |
Notion + Google Workspace 連携ガイド |
開発者向け
npm install
npm test # リグレッションテスト (502件)
npm run build # MCP Server ビルド
npm run quality # lint + typecheck + format:check前提: Node.js 20+, ShellCheck(オプション)。詳細は CONTRIBUTING.md を参照。
サブスキル
スキル | 用途 |
| ESLint + Prettier + Husky 導入 |
| GitHub Actions CI/CD パイプライン構築 |
| TypeScript 初期設定 |
| ブランチ戦略 + Conventional Commits |
| プロジェクトセットアップ自動化 |
| Notion + Google Workspace MCP 連携 |
| FigJam ダイアグラム生成 |
| 要件→仕様変換ブリッジ |
PM Tool Suite
このリポジトリは、Claude Code で PM ワークフローを自動化する5つのツールスイートの一部です。
# | Skill | Purpose | Repo |
1 | my_pm_tools | GitHub Projects V2 管理 | this repo |
2 | requirements_designer | 要件定義 + Figma UI生成 | |
3 | speckit-bridge | 要件→仕様変換(品質ゲート≥70) | |
4 | pm-data-analysis | GAFA品質データ分析 | |
5 | pm-ad-operations | 広告CSV分析(Google/Meta) |
Pipeline
requirements_designer → speckit-bridge → my_pm_tools (project tracking)
|
pm-data-analysis ← pm-ad-analysisRecommended Install Order
my_pm_tools (基盤 — GitHub Projects 環境構築)
requirements_designer (上流 — 要件定義)
speckit-bridge (変換 — 要件→仕様)
pm-data-analysis (分析 — データ駆動意思決定)
pm-ad-analysis (広告 — マルチチャネル最適化)
License
ISC License. See LICENSE for details.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/fideguch/my_pm_tools'
If you have feedback or need assistance with the MCP directory API, please join our Discord server