Productboard Automation

Productboard Automation

Automate your Productboard product management operations directly from Claude Code. Create notes from customer feedback, browse features and objectives, link entities, and track releases -- all without leaving your terminal.

Toolkit docs: composio.dev/toolkits/productboard

Setup

1. Add the Composio MCP server to your Claude Code config with URL: http://localhost:8787/mcp
2. When prompted, authenticate your Productboard account through the connection link provided
3. Start automating your product management workflows with natural language

Core Workflows

1. Manage Customer Notes

Create notes from customer feedback and organize them with tags, links, and followers.

Tools: PRODUCTBOARD_CREATE_NOTE, PRODUCTBOARD_LIST_NOTES, PRODUCTBOARD_ADD_NOTE_TAG, PRODUCTBOARD_ADD_NOTE_FOLLOWERS, PRODUCTBOARD_CREATE_NOTE_LINK

Create a note titled "Mobile app crash report" with content from customer feedback, tagged "bug" and linked to feature abc-123

Key parameters for PRODUCTBOARD_CREATE_NOTE:

• title (required) and content (required) -- note title and body
• customer_email or user.email -- attribute to a customer/user
• tags -- array of tag strings for categorization
• display_url -- URL linked from the note title
• source -- origin system with origin and record_id
• company -- associate with a company

Key parameters for PRODUCTBOARD_LIST_NOTES:

• createdFrom / createdTo -- ISO 8601 date range
• last -- relative time window (e.g., "6m", "10d", "24h")
• term -- full-text search by title or content
• allTags / anyTag -- filter by tags (cannot combine both)
• featureId, companyId, ownerEmail, source -- entity filters
• pageLimit (max 100) / pageCursor -- pagination

2. Browse and Retrieve Features

List all features/subfeatures and retrieve detailed information.

Tools: PRODUCTBOARD_LIST_FEATURES, PRODUCTBOARD_RETRIEVE_FEATURE

List the first 50 features in Productboard, then get details on feature abc-def-123

• PRODUCTBOARD_LIST_FEATURES supports pageLimit (default 100) and pageOffset for pagination
• PRODUCTBOARD_RETRIEVE_FEATURE requires feature id (UUID) to get complete details

3. Objectives and Key Results (OKRs)

List objectives, view feature-objective links, and browse key results.

Tools: PRODUCTBOARD_LIST_OBJECTIVES, PRODUCTBOARD_LIST_FEATURE_OBJECTIVES, PRODUCTBOARD_LIST_KEY_RESULTS

Show me all in-progress objectives owned by alice@example.com

Key parameters for PRODUCTBOARD_LIST_OBJECTIVES:

• status.name -- filter by status (e.g., "In Progress")
• owner.email -- filter by owner email
• parent.id -- filter by parent objective
• archived -- filter by archived state

PRODUCTBOARD_LIST_FEATURE_OBJECTIVES:

• Requires id (UUID) of a top-level feature (not subfeatures)
• Supports pageCursor for pagination

4. Component Management

List product components for organizing features and the product hierarchy.

Tool: PRODUCTBOARD_LIST_COMPONENTS

List all components in our Productboard workspace

• Supports page_limit and page_offset for pagination
• Follow links.next for additional pages

5. Release Tracking

View feature-release assignments with state and date filters.

Tool: PRODUCTBOARD_LIST_FEATURE_RELEASE_ASSIGNMENTS

Show all active release assignments for feature abc-123

• Filter by feature.id, release.id, release.state (planned, active, closed)
• Date range filters: release.timeframe.endDate.from and release.timeframe.endDate.to (YYYY-MM-DD)

6. Link Notes to Features

Connect customer feedback notes to product features for insight aggregation.

Tool: PRODUCTBOARD_CREATE_NOTE_LINK

Link note 3fa85f64-5717 to feature 1b6c8c76-8f5d for tracking

• Requires noteId (UUID) and entityId (UUID of feature, component, or product)
• Use after creating notes to ensure feedback is connected to the right product areas

Known Pitfalls

• Top-level features only for objectives: PRODUCTBOARD_LIST_FEATURE_OBJECTIVES only works with top-level feature IDs, not subfeature IDs. Use PRODUCTBOARD_LIST_FEATURES to identify which features are top-level.
• Tag filter exclusivity: allTags and anyTag cannot be combined in PRODUCTBOARD_LIST_NOTES. Choose one filter strategy per query.
• Relative vs. absolute dates: The last parameter (e.g., "24h") cannot be combined with createdFrom/createdTo in PRODUCTBOARD_LIST_NOTES. Use one approach, not both.
• Cursor-based pagination: Follow links.next or use pageCursor from responses for multi-page results. Offset-based and cursor-based pagination are used on different endpoints -- check each tool.
• Note attribution: Either user.email or customer_email must be provided in PRODUCTBOARD_CREATE_NOTE to attribute feedback. Without it, the note will have no customer association.
• UUID formats required: All entity IDs (features, notes, components) must be valid UUIDs. Passing malformed IDs causes 400 errors.

Quick Reference

Powered by Composio