productplan-mcp-server
This server lets AI assistants read, search, create, update, and delete ProductPlan data — roadmaps, bars, OKRs, ideas, opportunities, and launches — through natural language.
Roadmaps: list roadmaps; view settings, bars, lanes, milestones, legends, comments, or a complete roadmap overview
Bars: get bar details, children, comments, dependencies (connections), and links; create, update, move, color, tag, and delete bars
Bulk bar operations: create, update, or delete up to 100 bars in one validated call with optional dry-run
OKRs: list and view objectives/key results with progress; create, update, or delete objectives and key results
Discovery: list ideas, opportunities, customers, tags, and idea forms; create and update ideas and opportunities
Launches: list launches and view launch sections/tasks; create, update, or delete launches, sections, and tasks, including assigning users and tracking status
Admin/utility: check ProductPlan API status, MCP server health/cache stats, and list users and teams
ProductPlan MCP Server
Talk to your roadmaps using AI. Ask questions, create ideas, check OKR progress, and manage launches through natural conversation with Claude, Cursor, or other AI assistants.
What can you do with this?
Instead of clicking through ProductPlan's interface, just ask:
"What's on our Q1 roadmap?"
"Show me all objectives that are behind schedule"
"Create a new idea for mobile app improvements"
"What launches are coming up this month?"
"List all ideas tagged 'customer-request'"
"Color every eFormidling bar with the Customer satisfaction legend"
"Move these ten bars to the Platform lane and tag them Q3"
The AI fetches your real ProductPlan data and responds in seconds. Changes to many bars go through one validated call: every bar is checked before anything is written, and you can ask for a dry run first.
Related MCP server: plane-mcp-server
Who is this for?
Product Managers who want faster access to roadmap data
Team leads who need quick status updates without context-switching
Anyone using AI assistants (Claude, Cursor, etc.) who wants ProductPlan integrated into their workflow
No coding required. You'll copy a file and paste some settings.
Quick start (5 minutes)
Step 1: Get your ProductPlan API token
Log into ProductPlan
Go to Settings → API (or visit this link directly)
Copy your API token
Step 2: Download the app
Go to the Releases page and download the right file for your computer:
Your Computer | Download This |
Mac (M1, M2, M3, M4) |
|
Mac (Intel) |
|
Windows |
|
Linux |
|
On Mac/Linux, open Terminal and run these two commands (replace the filename with what you downloaded):
chmod +x ~/Downloads/productplan-darwin-arm64
sudo mv ~/Downloads/productplan-darwin-arm64 /usr/local/bin/productplanYou'll be asked for your password. This is normal.
On Windows:
Create a folder for the binary (if it doesn't exist):
mkdir C:\ToolsMove the downloaded
.exeto that folder and rename it:move %USERPROFILE%\Downloads\productplan-windows-amd64.exe C:\Tools\productplan.exeUse the full path
C:\Tools\productplan.exein your AI assistant config (shown in Step 3)
Note: You can skip adding to PATH. Just use the full file path in your configuration.
Step 3: Connect to your AI assistant
Pick the tool you use:
Find your config file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Open it in any text editor and add this (replace
your-tokenwith your actual API token):
Mac/Linux:
{
"mcpServers": {
"productplan": {
"command": "/usr/local/bin/productplan",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Windows:
{
"mcpServers": {
"productplan": {
"command": "C:\\Tools\\productplan.exe",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Restart Claude Desktop
Add to your config file:
Mac/Linux:
~/.claude.jsonWindows:
%USERPROFILE%\.claude.json
Mac/Linux:
{
"mcpServers": {
"productplan": {
"command": "/usr/local/bin/productplan",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Windows:
{
"mcpServers": {
"productplan": {
"command": "C:\\Tools\\productplan.exe",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Open Cursor
Go to Settings → MCP Servers
Add this configuration:
Mac/Linux:
{
"productplan": {
"command": "/usr/local/bin/productplan",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}Windows:
{
"productplan": {
"command": "C:\\Tools\\productplan.exe",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}Windows users: Use double backslashes (
\\) in the path. This is required because backslash is an escape character in JSON.
Install the Cline extension
Open VS Code settings (JSON) and add:
Mac/Linux:
{
"cline.mcpServers": {
"productplan": {
"command": "/usr/local/bin/productplan",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Windows:
{
"cline.mcpServers": {
"productplan": {
"command": "C:\\Tools\\productplan.exe",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
}
}Install the Continue extension
Add to your config file:
Mac/Linux:
~/.continue/config.jsonWindows:
%USERPROFILE%\.continue\config.json
Mac/Linux:
{
"mcpServers": [
{
"name": "productplan",
"command": "/usr/local/bin/productplan",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
]
}Windows:
{
"mcpServers": [
{
"name": "productplan",
"command": "C:\\Tools\\productplan.exe",
"env": {
"PRODUCTPLAN_API_TOKEN": "your-token"
}
}
]
}Set environment variable on your n8n instance:
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=trueAdd an MCP Client node to your workflow
Configure:
Command:
Mac/Linux:
/usr/local/bin/productplanWindows:
C:\Tools\productplan.exe
Environment Variables:
PRODUCTPLAN_API_TOKEN=your-token
Connect to an AI Agent node
Example workflow: Slack Trigger → AI Agent (with MCP Client) → Slack Response
Step 4: Start asking questions
Open your AI assistant and try:
"List my ProductPlan roadmaps"
"What bars are on roadmap [name]?"
"Show me our OKRs"
"What ideas are in discovery?"
Real-world use cases
Morning standup prep
"Summarize what changed on our Product Roadmap in the last week"
Stakeholder updates
"List all Q1 objectives and their progress"
Idea triage
"Show me all ideas tagged 'enterprise' that don't have a priority set"
Launch coordination
"What tasks are still incomplete for the January launch?"
Quick lookups
"When is the 'Mobile App v2' bar scheduled to start?"
What ProductPlan data can you access?
Feature | View | Create | Edit | Delete |
Roadmaps | Yes | - | - | - |
Roadmap Comments | Yes | - | - | - |
Bars (roadmap items) | Yes | Yes | Yes | Yes |
Bulk bar edits (up to 100 per call) | - | Yes | Yes | Yes |
Bar Comments | Yes | - | - | - |
Bar Connections | Yes | Yes | - | Yes |
Bar Links | Yes | Yes | - | Yes |
Lanes (categories) | Yes | Yes | Yes | Yes |
Legends (bar colors) | Yes | - | Assign to bars | - |
Milestones | Yes | Yes | Yes | Yes |
Ideas (Discovery) | Yes | Yes | Yes | - |
Idea Customers | Yes | - | - | - |
Idea Tags | Yes | - | - | - |
Opportunities | Yes | Yes | Yes | - |
Idea Forms | Yes | - | - | - |
Objectives (OKRs) | Yes | Yes | Yes | Yes |
Key Results | Yes | Yes | Yes | Yes |
Launches | Yes | Yes | Yes | Yes |
Launch Sections | Yes | Yes | Yes | Yes |
Launch Tasks | Yes | Yes | Yes | Yes |
Users | Yes | - | - | - |
Teams | Yes | - | - | - |
List tools take filters, so you can ask for exactly what you need: bars by name, dates, lane, legend or tag, and ideas, opportunities, launches and roadmaps by name or status.
Some things the ProductPlan API itself does not allow, so no tool can do them: creating legends, setting lane colors, writing comments, removing a bar from its container once nested, and creating Azure DevOps or Jira integration links (links made through the API are plain web links).
How it works
┌─────────────────┐ spawns ┌─────────────────┐ API calls ┌─────────────────┐
│ AI Assistant │ ───────────────── │ MCP Server │ ─────────────────▶ │ ProductPlan │
│ (Claude, Cursor)│ ◀───────────────▶ │ (this binary) │ ◀───────────────── │ API │
└─────────────────┘ stdin/stdout └─────────────────┘ JSON data └─────────────────┘
your computer your computer cloudWhy does this need to run on your computer?
MCP (Model Context Protocol) works through a subprocess model. Your AI assistant doesn't connect to a remote server; it spawns the binary as a local process and communicates via stdin/stdout. This architecture means:
The binary must exist locally because your AI assistant runs it as a child process
Your API token stays on your machine, never passing through third-party servers
Real-time, synchronous communication without network latency between AI and the MCP server
Works offline for cached data (though ProductPlan API calls still need internet)
When you ask "What's on our Q1 roadmap?", here's what happens:
Your AI assistant recognizes it needs ProductPlan data
It sends a structured request to the MCP server process
The binary translates this into ProductPlan API calls
ProductPlan returns JSON data
The binary formats and returns results to your AI
Your AI presents the answer in natural language
Agent Skills
Pre-built workflow guides that teach AI assistants how to use ProductPlan tools effectively. Each skill targets a specific persona with tailored workflows.
Skill | Audience | Focus |
General | Core patterns and tool reference | |
Product Managers | Full toolkit: roadmaps, OKRs, ideas, launches | |
Executives | Portfolio health, cross-roadmap views | |
Sales & CS | Customer-ready roadmap timelines |
Shared Principles
All skills follow these output conventions:
No raw JSON - Format responses as readable text and tables
Human-readable dates - Use "March 2025" or "Q1 2025", not "2025-03-15"
Summarize large lists - Don't overwhelm with 50 items; offer to expand
Persona-specific variations:
PM includes
bar_idfor follow-up actionsLeadership leads with executive summary, hides implementation details
Customer-facing omits internal IDs, lane names, and OKRs entirely
To use a skill, copy the SKILL.md file to your Claude Code skills directory:
# Copy a skill (example: PM skill)
cp skills/productplan-pm/SKILL.md ~/.claude/skills/productplan-pm.mdOr reference skills directly in your prompts:
"Use the productplan-pm workflow to show me our Q1 roadmap"
Troubleshooting
"Command not found" or "spawn ENOENT"
Your AI assistant can't find the binary. This means:
Mac/Linux: The file isn't at
/usr/local/bin/productplan, or you forgot to runchmod +xWindows: The path in your config doesn't match where you saved the
.exe
Fix: Verify the binary exists at the path in your config. Run ls -la /usr/local/bin/productplan (Mac/Linux) or check if C:\Tools\productplan.exe exists (Windows).
Windows path issues
Common mistakes on Windows:
Wrong | Correct |
|
|
|
|
|
|
Missing | Include |
Windows uses backslashes (\) for paths, but JSON treats backslash as an escape character. You must double them (\\) in your config file.
"Invalid API token"
Double-check your token at ProductPlan Settings → API. Tokens can expire or be regenerated. Make sure you copied the full token without extra spaces.
"No roadmaps found"
Your API token only accesses data you have permission to see in ProductPlan. Check that your account has access to the roadmaps you're looking for.
AI assistant doesn't see ProductPlan tools
MCP servers load when your AI assistant starts, not when configs change. After editing your config file, fully quit and restart the application. On Mac, use Cmd+Q (not just closing the window).
A bar's color didn't change
Colors are set by legend name (for example "Committed"), not by an ID. Ask your assistant to list the roadmap's legends first. Versions before 6.0.0 sent a legend_id, which ProductPlan treats as "remove the color"; upgrade if colors keep disappearing.
"unknown argument" errors
Since 6.0.0 the server refuses arguments a tool doesn't have, and suggests the closest valid one ("did you mean legend?"). That usually means the assistant guessed a parameter name; it can retry with the suggestion.
"Permission denied" on Mac/Linux
The binary needs execute permission. Run:
chmod +x /usr/local/bin/productplanCommand line (optional)
You can also use this tool directly in Terminal without an AI assistant:
# First, set your token
export PRODUCTPLAN_API_TOKEN="your-token"
# Then run commands
productplan status # Check connection
productplan roadmaps # List all roadmaps
productplan bars 12345 # List bars in roadmap #12345
productplan objectives # List all OKRs
productplan ideas # List all ideas
productplan opportunities # List all opportunities
productplan launches # List all launchesOptional setting: PRODUCTPLAN_CACHE_TTL controls how long read results are cached in memory (default 60s; 0 turns the cache off). Any change you make through the server clears the cache immediately.
Background info
What is MCP?
Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools. Anthropic created it; other AI providers are adopting it. This server implements MCP so your AI assistant can read and write ProductPlan data.
What is ProductPlan?
ProductPlan is roadmap software used by 4,000+ product teams. It handles roadmaps, OKRs, idea discovery, and launch coordination.
For Developers
productplan-mcp-server/
├── cmd/productplan/main.go # Entry point: token check, then MCP server or CLI
├── internal/
│ ├── api/ # ProductPlan API client
│ │ ├── client.go # HTTP client: auth, rate limiting, error wrapping
│ │ ├── transport.go # Tuned HTTP transport
│ │ ├── cache.go # In-process TTL read cache (singleflight, write invalidation)
│ │ ├── list.go # Paged collection GETs and Ransack query encoding
│ │ ├── ids.go # Typed resource IDs (BarID, RoadmapID, ...), each validated into a path segment
│ │ ├── path.go # Routes and request paths built only from typed IDs
│ │ ├── safeseg.go # Path-segment validation for user-supplied IDs
│ │ ├── endpoints*.go # Endpoint methods (roadmaps, bars, ideas, launches, OKRs)
│ │ ├── bars_read.go # Roadmap bars with lane enrichment and client-side filters
│ │ ├── bar_schema.go # Roadmap legends/lanes/custom fields for bar writes
│ │ └── formatters.go # Response projection for AI
│ ├── mcp/ # MCP wiring over the official go-sdk
│ │ ├── sdk_server.go # Serves the registry via go-sdk (stdio)
│ │ ├── sdk.go # Converts local Tool -> SDK tool
│ │ ├── handler.go # Registry: dispatch and panic recovery
│ │ ├── argkeys.go # Rejects undeclared argument keys (did-you-mean)
│ │ ├── editdistance.go # Levenshtein distance for suggestions
│ │ └── types.go # Tool-authoring types
│ ├── tools/ # Tool definitions and handlers
│ │ ├── registry.go # Tool registration (name -> handler)
│ │ ├── definitions*.go # Tool schemas and descriptions
│ │ ├── helpers.go # typedHandler, manage-action dispatch
│ │ ├── filters.go # List-tool filters -> Ransack predicates
│ │ ├── formatter.go # List/item/action response summaries
│ │ ├── item_type.go # Item nouns for summaries
│ │ ├── bar_planner.go # Validates bar writes against the roadmap
│ │ ├── bar_names.go # Legend/lane/custom field name resolution
│ │ ├── bulk_bars.go # bulk_update/create/delete_bars
│ │ ├── roadmaps.go, bars.go, ideas.go, objectives.go, launches.go, utility.go # handlers
│ │ └── types*.go # Typed argument structs for handlers
│ ├── cli/ # CLI commands (status, roadmaps, etc.)
│ │ └── cli.go
│ └── logging/ # slog JSON handler setup (ts/level/msg)
│ └── logger.go
├── pkg/productplan/ # Reusable utilities
│ ├── retry.go # Exponential backoff with jitter
│ ├── ratelimit.go # Adaptive rate limiting
│ ├── batch.go # Batched operations
│ ├── health.go # Health reporting
│ ├── requestid.go # Request tracing
│ ├── validation.go # ID validation (Field.RequireID)
│ └── errors.go # APIError and error suggestions
└── evals/ # LLM evaluation test suite
├── runner.go, types.go
├── tool_selection.json
├── confusion_pairs.json
└── argument_correctness.jsonRequires Go 1.26 or newer.
git clone https://github.com/olgasafonova/productplan-mcp-server.git
cd productplan-mcp-server
go build -o productplan ./cmd/productplanBuild for all platforms:
# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -o dist/productplan-darwin-arm64 ./cmd/productplan
# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o dist/productplan-darwin-amd64 ./cmd/productplan
# Linux
GOOS=linux GOARCH=amd64 go build -o dist/productplan-linux-amd64 ./cmd/productplan
# Windows
GOOS=windows GOARCH=amd64 go build -o dist/productplan-windows-amd64.exe ./cmd/productplanRun all tests:
go test ./...Run with coverage:
go test ./... -coverRun benchmarks:
go test ./internal/... -bench=. -benchmemRun evaluation suite:
./scripts/run-evals.shCoverage (measured 24-09-2026, go test ./... -cover):
Package | Coverage |
internal/logging | 100% |
pkg/productplan | 94.5% |
internal/mcp | 92.5% |
internal/cli | 92.3% |
evals | 89.5% |
internal/api | 87.4% |
internal/tools | 82.3% |
cmd/productplan | 34.9% |
Every production file scores 10.0 in CodeScene Code Health (two type-only files can't be scored).
50 tools available: 35 READ tools and 15 WRITE tools (12 action-based manage_* plus 3 bulk_* bar tools):
Read tools:
Roadmaps:
list_roadmaps,get_roadmap,get_roadmap_bars,get_roadmap_lanes,get_roadmap_milestones,get_roadmap_legends,get_roadmap_comments,get_roadmap_completeBars:
get_bar,get_bar_children,get_bar_comments,get_bar_connections,get_bar_linksOKRs:
list_objectives,get_objective,list_key_results,get_key_resultDiscovery:
list_ideas,get_idea,list_all_customers,list_all_tags,list_opportunities,get_opportunity,list_idea_forms,get_idea_formLaunches:
list_launches,get_launch,get_launch_sections,get_launch_section,get_launch_tasks,get_launch_taskAdmin:
check_status,health_check,list_users,list_teams
Write tools:
Roadmaps:
manage_bar,manage_lane,manage_milestoneBar relationships:
manage_bar_connection,manage_bar_linkBulk bars:
bulk_update_bars,bulk_create_bars,bulk_delete_bars(up to 100 bars per call, validated up front,dry_runsupported)OKRs:
manage_objective,manage_key_resultDiscovery:
manage_idea,manage_opportunityLaunches:
manage_launch,manage_launch_section,manage_launch_task
Example:
{"tool": "list_roadmaps", "arguments": {}}
{"tool": "manage_bar", "arguments": {"action": "create", "roadmap_id": "123", "lane": "Backend", "name": "New feature", "legend": "Committed"}}
{"tool": "bulk_update_bars", "arguments": {"set": {"legend": "Committed"}, "items": [{"bar_id": "901"}, {"bar_id": "902"}], "dry_run": true}}
{"tool": "manage_idea", "arguments": {"action": "create", "name": "Mobile app improvements"}}The server uses a clean layered architecture:
┌──────────────────────────────────────────────────────────────┐
│ cmd/productplan │
│ (entry point, DI) │
└──────────────────────────────────────────────────────────────┘
│
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ internal/cli │ │ internal/mcp │ │internal/tools │
│ (CLI cmds) │ │ (MCP / SDK) │ │ (handlers) │
└───────────────┘ └───────────────┘ └───────────────┘
│ │
└──────────┬──────────┘
▼
┌───────────────────┐
│ internal/api │
│ (HTTP client) │
└───────────────────┘
│
▼
┌───────────────────┐
│ ProductPlan API │
└───────────────────┘Key interfaces:
// Tool handler interface (internal/mcp)
type Handler interface {
Handle(ctx context.Context, args map[string]any) (json.RawMessage, error)
}
// Logging (internal/logging): a *slog.Logger with a JSON handler on stderr
logger := logging.New(slog.LevelInfo)Logging format:
{"ts":"2026-09-24T10:30:00.123456789Z","level":"debug","msg":"API response","endpoint":"/roadmaps/5","status_code":200,"dur_ms":245}Changelog
See CHANGELOG.md for release history and detailed changes.
Like This Project?
If this server saved you time, consider giving it a ⭐ on GitHub. It helps others discover the project.
More MCP Servers
Check out my other MCP servers:
Server | Description | Stars |
Access GLEIF LEI database. Look up company identities, verify legal entities. | ||
Connect AI to any MediaWiki wiki. Search, read, edit wiki content. | ||
Control Miro whiteboards with AI. Boards, diagrams, mindmaps, and more. | ||
Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden. | ||
Nordic grocery deal hunting. Find offers, plan meals, track spending. |
License
MIT License - see LICENSE
Available Tools
50 toolsbulk_create_barsA
Create many bars on one roadmap in one call.
USE WHEN: "Add these 20 features to the roadmap", "Import this list as bars", "Create a bar per epic" For a single bar, use manage_bar instead. Each item needs name and a lane (lane name or lane_id), from the item or from set. Put shared values in set (e.g. set:{"lane":"Backend","legend":"Exploring"}). Up to 100 items. All items are validated against the roadmap before anything is written; one invalid item means nothing is sent. dry_run:true returns the exact POST payloads without writing. Parking follows manage_bar: a bar given starts_on and ends_on and no parked lands on the timeline (parked:false); an undated bar is parked by ProductPlan's default; a nested bar inherits its container's parked state. Writes run 4 at a time under the client's rate limiter. Returns per-item {index, bar_id, name, ok, error} and a summary like "Created 18 of 20 bars; 2 failed". The result is an error only when no bar was created. On a partial failure, retry only the failed items: resending the whole call would duplicate the bars that were created. FAILS WHEN: roadmap_id missing, items empty or over 100, an item without name or lane, a name not on the roadmap.
Inputs: items (required), roadmap_id (required), set, dry_run.
bulk_delete_barsADestructive
Permanently delete many bars in one call, verifying each delete.
USE WHEN: "Delete these bars", "Remove all the test bars I just made", "Clean up the parked duplicates" For a single bar, use manage_bar action=delete instead. Requires confirm:true. dry_run:true looks each bar up and returns its name without deleting, so the list can be checked first. Up to 100 bar_ids, each once. Each delete is verified by reading the bar back and expecting 404; a bar that still exists after a successful-looking delete is reported as failed. Deletes run 4 at a time under the client's rate limiter. Returns per-item {index, bar_id, ok, error} and a summary like "Deleted 9 of 10 bars; 1 failed". The result is an error only when no bar was deleted. FAILS WHEN: confirm is not true (and dry_run is not set), bar_ids empty, over 100, malformed, or repeated. WARNING: delete is permanent and cannot be undone.
Inputs: bar_ids (required), confirm, dry_run.
bulk_update_barsADestructive
Update many bars in one call: recolor, move lanes, retag, reschedule, set progress.
USE WHEN: "Color all these bars Committed", "Move these 12 bars to the Backend lane", "Set percent_done on every Q3 bar" For a single bar, use manage_bar instead. Put values shared by every bar in set (e.g. set:{"legend":"Committed"}) and per-bar values in items; an item's own fields override set. Up to 100 items; each bar_id may appear once. Every item is validated before anything is written: legend, lane, custom field labels, and dropdown values are checked against each bar's roadmap (one roadmap fetch per distinct roadmap; pass roadmap_id to skip looking up each bar's roadmap). One invalid item means nothing is sent, and the error lists every problem with the valid options. dry_run:true returns the exact PATCH payload per bar without writing. Writes run 4 at a time under the client's rate limiter. Returns per-item {index, bar_id, ok, error} and a summary like "Updated 28 of 30 bars; 2 failed". The result is an error only when no bar was updated. A partial failure is a normal result whose summary counts the failures; retry only the failed items. FAILS WHEN: items empty or over 100, a bar_id missing or repeated, a name not on the roadmap, legend_id or effort passed (see manage_bar).
Inputs: items (required), set, dry_run, roadmap_id.
check_statusARead-only
Check ProductPlan API status and authentication.
USE WHEN: "Is ProductPlan connected?", "Check API" For MCP server internals (cache stats, rate limits), use health_check instead.
Returns: data, summary
get_barARead-only
Get bar details including description, links, custom fields.
USE WHEN: "Tell me about this feature", "Bar details" Returns bar name, dates, description, links, custom fields, percent_done, and lane info. FAILS WHEN: bar_id not found (get valid IDs from get_roadmap_bars).
Inputs: bar_id (required). Returns: data, summary
get_bar_childrenARead-only
Get child bars nested under a parent bar.
USE WHEN: "Show sub-tasks", "Child items", "Break down this feature" FAILS WHEN: bar_id not found. Returns empty list if bar has no children (not all bars are containers).
Inputs: bar_id (required). Returns: data, summary
get_bar_commentsARead-only
Get comments on a bar.
USE WHEN: "Show comments", "What's the feedback on this bar?" For roadmap-level comments, use get_roadmap_comments instead. FAILS WHEN: bar_id not found.
Inputs: bar_id (required). Returns: data, summary
get_bar_connectionsARead-only
Get bar dependencies (what blocks what).
USE WHEN: "What depends on this?", "Show dependencies" FAILS WHEN: bar_id not found. Returns empty list if bar has no connections.
Inputs: bar_id (required). Returns: data, summary
get_bar_linksARead-only
Get external links on a bar (Jira, docs, designs).
USE WHEN: "What's linked?", "Show Jira tickets" FAILS WHEN: bar_id not found. Returns empty list if bar has no external links.
Inputs: bar_id (required). Returns: data, summary
get_ideaARead-only
Get idea details including description and metadata.
USE WHEN: "Tell me about this idea", "Full request details" FAILS WHEN: idea_id not found (get valid IDs from list_ideas).
Inputs: idea_id (required). Returns: data, summary
get_idea_formARead-only
Get idea form details with fields.
USE WHEN: "Show form fields", "What does this form collect?" FAILS WHEN: form_id not found (get valid IDs from list_idea_forms).
Inputs: form_id (required). Returns: data, summary
get_key_resultARead-only
Get key result details.
USE WHEN: "Tell me about this KR", "KR progress" FAILS WHEN: objective_id or key_result_id not found (use list_key_results to get valid KR IDs).
Inputs: objective_id (required), key_result_id (required). Returns: data, summary
get_launchARead-only
Get launch details with checklist.
USE WHEN: "Tell me about this launch", "Launch readiness" FAILS WHEN: launch_id not found (get valid IDs from list_launches).
Inputs: launch_id (required). Returns: data, summary
get_launch_sectionARead-only
Get a specific checklist section by ID.
USE WHEN: "Show one specific checklist section by ID" For all sections, use get_launch_sections. FAILS WHEN: launch_id or section_id not found.
Inputs: launch_id (required), section_id (required). Returns: data, summary
get_launch_sectionsARead-only
Get checklist sections for a launch.
USE WHEN: "Show sections", "Checklist categories" For one specific section, use get_launch_section. FAILS WHEN: launch_id not found.
Inputs: launch_id (required). Returns: data, summary
get_launch_taskARead-only
Get a specific launch task by ID.
USE WHEN: "Show one specific task by ID", "Check task assignment or status" For all tasks, use get_launch_tasks. FAILS WHEN: launch_id or task_id not found.
Inputs: task_id (required), launch_id (required). Returns: data, summary
get_launch_tasksARead-only
Get all tasks for a launch.
USE WHEN: "Show tasks", "What needs to be done?" For one specific task, use get_launch_task. FAILS WHEN: launch_id not found.
Inputs: launch_id (required). Returns: data, summary
get_objectiveARead-only
Get objective details with key results.
USE WHEN: "Tell me about objective X", "OKR progress" FAILS WHEN: objective_id not found (get valid IDs from list_objectives).
Inputs: objective_id (required). Returns: data, summary
get_opportunityARead-only
Get opportunity details with linked ideas.
USE WHEN: "Tell me about this opportunity" FAILS WHEN: opportunity_id not found (get valid IDs from list_opportunities).
Inputs: opportunity_id (required). Returns: data, summary
get_roadmapARead-only
Get roadmap settings and metadata.
USE WHEN: "Tell me about roadmap X", "Roadmap settings", "What custom fields does this roadmap have?" For all data in one call (bars, lanes, milestones), use get_roadmap_complete. Returns roadmap name, date range, sharing settings, and metadata, including the vocabulary bar writes must use: legends (names), lanes (names), custom_text_fields [{label}], and custom_dropdown_fields [{label, allowed_values}]. manage_bar and the bulk_*_bars tools validate against exactly these. FAILS WHEN: roadmap_id not found (get valid IDs from list_roadmaps first).
Inputs: roadmap_id (required). Returns: data, summary
get_roadmap_barsARead-only
Get bars (features/items) on a roadmap, optionally filtered.
USE WHEN: "What's on the roadmap?", "Show planned features", "What's starting in Q2?", "Bars in the Mobile lane tagged urgent" Server-side filters (sent to ProductPlan): name_contains, starts_after/starts_before, ends_after/ends_before (YYYY-MM-DD, inclusive), is_container, sort ("starts_on asc"). Client-side filters (applied here to every fetched bar, before the 50-item cap): lane (name or ID), legend (name), tag. Exact, case-insensitive. Returns bars with ID, name, starts_on/ends_on, lane_name and lane_id, legend, tags, percent_done, is_container, and parked. For a bar's description and custom fields, use get_bar. FAILS WHEN: roadmap_id not found (use list_roadmaps); a date is not YYYY-MM-DD; sort names a field outside the allowed list (the error lists them). Says "No bars matched the filters" when filters exclude everything.
Inputs: roadmap_id (required), tag, lane, sort, +7 more. Returns: data, summary
get_roadmap_commentsARead-only
Get roadmap-level comments (not bar comments).
USE WHEN: "Show roadmap comments", "Roadmap discussion" For bar-level comments, use get_bar_comments instead. Returns array of comments with author, body, and timestamp. FAILS WHEN: roadmap_id not found (use list_roadmaps).
Inputs: roadmap_id (required). Returns: data, summary
get_roadmap_completeARead-only
Get complete roadmap in one call. Details, bars, lanes, milestones combined.
USE WHEN: "Full roadmap overview", "Summarize roadmap X" For settings/metadata only, use get_roadmap. Returns combined roadmap details, bars, lanes, and milestones in one response. FAILS WHEN: roadmap_id not found (use list_roadmaps).
Inputs: roadmap_id (required). Returns: data, summary
get_roadmap_lanesARead-only
Get lanes (categories) on a roadmap. Lanes organize bars into rows.
USE WHEN: "What lanes are on the roadmap?", "Show categories" Returns array of lanes with ID, name, description, and position (the API exposes no lane color). FAILS WHEN: roadmap_id not found (use list_roadmaps).
Inputs: roadmap_id (required). Returns: data, summary
get_roadmap_legendsARead-only
Get the legend names (bar colors) for a roadmap.
USE WHEN: "What colors are available?", "Show the legend", "Which legend can I color bars with?"
Returns an array of legend names. The ProductPlan API exposes legends by name only: there is no legend ID or hex color to return. Pass a name as legend on manage_bar, bulk_update_bars, or bulk_create_bars to color a bar.
For custom field definitions (labels, dropdown allowed_values), use get_roadmap instead. To find bars by legend, use get_roadmap_bars with legend.
FAILS WHEN: roadmap_id not found (use list_roadmaps).
Inputs: roadmap_id (required). Returns: data, summary
get_roadmap_milestonesARead-only
Get milestones (key dates) on a roadmap.
USE WHEN: "What are the key dates?", "Show milestones" Returns array of milestones with ID, title, and date. FAILS WHEN: roadmap_id not found (use list_roadmaps).
Inputs: roadmap_id (required). Returns: data, summary
health_checkARead-only
Check MCP server health and cache stats.
USE WHEN: "Server status", "Rate limits", "Diagnose issues" For API connectivity only, use check_status instead. FAILS WHEN: deep=true and API is unreachable. Basic health (deep=false) always succeeds if server is running.
Inputs: deep. Returns: data, summary
list_all_customersARead-only
List all customers across ideas. Returns customer names and linked idea counts.
USE WHEN: "Who are our customers?", "All feedback sources" FAILS WHEN: API token invalid.
Returns: data, summary
list_all_tagsARead-only
List all tags used across ideas. Returns tag names and usage counts across ideas.
USE WHEN: "What tags exist?", "Show categories" FAILS WHEN: API token invalid.
Returns: data, summary
list_idea_formsARead-only
List idea submission forms.
USE WHEN: "Show feedback forms", "What forms exist?" Returns array of forms with ID and name. FAILS WHEN: API token invalid.
Returns: data, summary
list_ideasARead-only
List all ideas in discovery pipeline. START HERE for ideas.
USE WHEN: "Show customer feedback", "What ideas do we have?", "Ideas mentioning SSO" Optional server-side filters: name_contains (case-insensitive), channel (exact); sort ("name asc"). Returns ideas with ID, name, channel, and opportunities_count. FAILS WHEN: API token invalid; sort names a field outside the allowed list (the error lists them). Returns empty list if no ideas exist.
Inputs: sort, channel, name_contains. Returns: data, summary
list_key_resultsARead-only
List key results for an objective.
USE WHEN: "What are the KRs?", "Show metrics" Returns array of key results with ID, name, target_value, and current_value. FAILS WHEN: objective_id not found (use list_objectives).
Inputs: objective_id (required). Returns: data, summary
list_launchesARead-only
List all launches. START HERE for launches.
USE WHEN: "Show launches", "Release schedule", "Launches this quarter" Optional server-side filters: name_contains (case-insensitive), status (exact), launch_after/launch_before (YYYY-MM-DD, inclusive); sort ("launch_date asc"). Returns array of launches with ID, name, launch_date, status, and progress. FAILS WHEN: API token invalid; a date is not YYYY-MM-DD; sort names a field outside the allowed list (the error lists them). Returns empty list if no launches exist.
Inputs: sort, status, launch_after, launch_before, +1 more. Returns: data, summary
list_objectivesARead-only
List all OKR objectives. START HERE for OKRs.
USE WHEN: "Show OKRs", "What are our objectives?" Returns array of objectives with ID, name, risk_status, start_date, end_date, and key_results_count. FAILS WHEN: API token invalid. Returns empty list if no objectives exist.
Returns: data, summary
list_opportunitiesARead-only
List all opportunities. START HERE for discovery.
USE WHEN: "Show opportunities", "Discovery pipeline", "Opportunities about onboarding" Optional server-side filters: problem_contains (case-insensitive), workflow_status (exact); sort ("ideas_count desc"). Returns array of opportunities with ID, problem_statement, workflow_status, and linked idea count. FAILS WHEN: API token invalid; sort names a field outside the allowed list (the error lists them). Returns empty list if no opportunities exist.
Inputs: sort, workflow_status, problem_contains. Returns: data, summary
list_roadmapsARead-only
List all roadmaps. START HERE to get roadmap IDs.
USE WHEN: "Show my roadmaps", "What roadmaps do I have?", "Find the Mobile roadmap" Optional server-side filters: name_contains (case-insensitive); sort ("name asc", "updated_at desc"). Returns roadmaps with ID, name, and updated_at. FAILS WHEN: API token invalid or expired (check PRODUCTPLAN_API_TOKEN env var); sort names a field outside the allowed list (the error lists them).
Inputs: sort, name_contains. Returns: data, summary
list_teamsARead-only
List all teams in account.
USE WHEN: "What teams exist?", "Team structure" For individual user details, use list_users instead.
Returns: data, summary
list_usersARead-only
List all users in account.
USE WHEN: "Who has access?", "Team members" Returns array of users with ID, name, email, and role. Use user IDs from this tool when assigning launch tasks via manage_launch_task.
Returns: data, summary
manage_barADestructive
Create, update, or delete a bar on a roadmap.
USE WHEN: "Add feature", "Update dates", "Delete item", "Change color", "Nest this bar under that one" For many bars at once (e.g. "color these 30 bars"), use bulk_update_bars, bulk_create_bars, or bulk_delete_bars instead. Actions: create (roadmap_id + name + lane or lane_id), update (bar_id + any fields), delete (bar_id) Color a bar with legend (a legend NAME from get_roadmap_legends); legend:"" or clear_legend:true removes the color. Omitted fields are never sent, so an update only touches what you pass. New bars are parked (off the timeline) by ProductPlan's default. When you give starts_on and ends_on on create and leave parked unset, the bar defaults to parked:false so it lands on the timeline; a nested bar inherits its container's parked state. Names (legend, lane, custom field labels, dropdown values) are checked against the roadmap before writing, matched case-insensitively, and sent in canonical spelling. Returns: create gives the new bar's id plus the bar read back; update gives the exact fields sent. FAILS WHEN: create without roadmap_id, name, or a lane; update/delete without bar_id; a legend, lane, or custom field name is not on the roadmap (the error lists the valid ones); container_bar_id on a bar without both dates, or a parked state that differs from the container's. legend_id and effort are rejected with an explanation (legend_id would wipe the bar's color). A bar cannot be un-nested via the API once container_bar_id is set. WARNING: delete is permanent and cannot be undone.
Inputs: action (required), lane, name, tags, +20 more.
manage_bar_connectionADestructive
Create or delete dependency between bars.
USE WHEN: "Link features", "Add dependency", "Remove dependency" Actions: create (target_bar_id), delete (connection_id) FAILS WHEN: create without target_bar_id, delete without connection_id (get IDs from get_bar_connections).
Inputs: action (required), bar_id (required), connection_id, target_bar_id.
manage_bar_linkADestructive
Create or delete external link on a bar.
USE WHEN: "Link Jira ticket", "Add design doc", "Remove link" Actions: create (url), delete (link_id) FAILS WHEN: create without url, delete without link_id (get IDs from get_bar_links). Note: update not available via API; delete and re-create instead.
Inputs: action (required), bar_id (required), url, name, +1 more.
manage_ideaADestructive
Create or update an idea. Note: delete not available via API.
USE WHEN: "Add idea", "Update idea status" Actions: create (title), update (idea_id) Returns the created/updated idea object. FAILS WHEN: create without title, update without idea_id. Note: delete is not available via the ProductPlan API; archive ideas by updating status instead.
Inputs: action (required), title, status, idea_id, +1 more.
manage_key_resultADestructive
Create, update, or delete a key result.
USE WHEN: "Add KR", "Update progress", "Delete KR" Actions: create (name+target), update (key_result_id), delete (key_result_id) Returns the created/updated key result, or confirmation on delete. FAILS WHEN: create without name or target_value, update/delete without key_result_id (use list_key_results).
Inputs: action (required), objective_id (required), name, target_value, +2 more.
manage_laneADestructive
Create, update, or delete a lane on a roadmap.
USE WHEN: "Add Backend lane", "Rename Mobile lane", "Move lane to the top", "Delete lane" Actions: create (name; optional description, position), update (lane_id plus any of name, description, position), delete (lane_id) Returns the created/updated lane object, or confirmation on delete. FAILS WHEN: create without name, update/delete without lane_id (get IDs from get_roadmap_lanes), color passed (lanes have no settable color in the API). WARNING: delete removes the lane and unassigns all bars in it.
Inputs: action (required), roadmap_id (required), name, color, +3 more.
manage_launchADestructive
Create, update, or delete a launch.
USE WHEN: "Create launch", "Update date", "Delete launch" Actions: create (name+date), update (launch_id), delete (launch_id) Returns the created/updated launch object, or confirmation on delete. FAILS WHEN: create without name or date, update/delete without launch_id, date not in YYYY-MM-DD format. WARNING: delete removes the launch and all its sections and tasks.
Inputs: action (required), date, name, launch_id, +1 more.
manage_launch_sectionADestructive
Create, update, or delete a checklist section.
USE WHEN: "Add Marketing section", "Rename section", "Delete section" Actions: create (name), update (section_id), delete (section_id) Returns the created/updated section object, or confirmation on delete. FAILS WHEN: create without name, update/delete without section_id (get IDs from get_launch_sections). WARNING: delete removes the section and all tasks in it.
Inputs: action (required), launch_id (required), name, section_id.
manage_launch_taskADestructive
Create, update, or delete a launch task.
USE WHEN: "Add task", "Mark complete", "Assign task", "Delete task" Actions: create (name+section_id), update (task_id), delete (task_id) Returns the created/updated task object, or confirmation on delete. FAILS WHEN: create without name or section_id, update/delete without task_id (get IDs from get_launch_tasks). Use list_users to get valid assigned_user_id values.
Inputs: action (required), launch_id (required), name, status, +5 more.
manage_milestoneADestructive
Create, update, or delete a milestone on a roadmap.
USE WHEN: "Add launch milestone", "Move demo date", "Delete milestone" Actions: create (title+date), update (milestone_id), delete (milestone_id) Returns the created/updated milestone object, or confirmation on delete. FAILS WHEN: create without title or date, update/delete without milestone_id (get IDs from get_roadmap_milestones), date not in YYYY-MM-DD format.
Inputs: action (required), roadmap_id (required), date, title, +1 more.
manage_objectiveADestructive
Create, update, or delete an objective.
USE WHEN: "Add Q1 objective", "Update objective", "Delete OKR" Actions: create (name), update (objective_id), delete (objective_id) Returns the created/updated objective, or confirmation on delete. FAILS WHEN: create without name, update/delete without objective_id. WARNING: delete also removes all key results under this objective.
Inputs: action (required), name, time_frame, description, +1 more.
manage_opportunityADestructive
Create or update an opportunity. Note: delete not available via API.
USE WHEN: "Create opportunity", "Update problem" Actions: create (problem_statement), update (opportunity_id) Returns the created/updated opportunity object. FAILS WHEN: create without problem_statement, update without opportunity_id (get IDs from list_opportunities). Note: delete is not available via the ProductPlan API; archive opportunities by updating workflow_status instead.
Inputs: action (required), description, opportunity_id, workflow_status, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 50 tools
Each tool pairs a distinct resource with a clear read/write action, and the get_/list_/manage_/bulk_ prefixes make intent obvious. Plural-versus-singular pairs like get_launch_sections and get_launch_section are explicitly annotated so an agent can reliably choose the right one.
The set follows a consistent convention: list_* for collections, get_* for single objects/details, manage_* for create/update/delete, and bulk_*_bars for multi-bar operations. Minor exceptions such as check_status and health_check are still self-describing and do not break the overall pattern.
Fifty tools is far beyond the typical well-scoped MCP surface and forces agents to consider a very long list for any task. The tools are individually justified, but the sheer count makes the server feel heavy and increases selection cost.
The server covers nearly every lifecycle needed for ProductPlan work: bars, lanes, milestones, launches, sections, tasks, objectives, key results, ideas, opportunities, links, and dependencies all have appropriate read/write tools. The main gaps are that roadmaps themselves cannot be created/updated/deleted and comments are read-only, though these are likely API constraints rather than design oversights.
Maintenance
Related MCP Connectors
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
MCP server for generating rough-draft project plans from natural-language prompts.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for controlling Miro whiteboards with AI assistants. Create and manage stickies, shapes, frames, connectors, and more.8832MIT
- AlicenseCqualityDmaintenanceMCP server for Plane integration, enabling AI agents to interact with Plane APIs and services for project management tasks.100MIT
- AlicenseAqualityDmaintenanceMCP server exposing 40 best-practice product management skills plus workflows and lifecycle tools, instantly accessible to any AI via Model Context Protocol.19152 npm21Apache 2.0
- FlicenseNot gradedqualityDmaintenanceAn unofficial MCP server for DevRev integration, enabling AI assistants to search, manage works, explore product hierarchies, and retrieve object details seamlessly.3-