SKILL.md
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
- Add the Rube MCP server to your Claude Code config with URL:
https://rube.app/mcp - When prompted, authenticate your Productboard account through the connection link provided
- 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: PRODUCTBOARDCREATENOTE, PRODUCTBOARDLISTNOTES, PRODUCTBOARDADDNOTETAG, PRODUCTBOARDADDNOTEFOLLOWERS, PRODUCTBOARDCREATENOTE_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 PRODUCTBOARDCREATENOTE:
title(required) andcontent(required) -- note title and bodycustomer_emailoruser.email-- attribute to a customer/usertags-- array of tag strings for categorizationdisplay_url-- URL linked from the note titlesource-- origin system withoriginandrecord_idcompany-- associate with a company
Key parameters for PRODUCTBOARDLISTNOTES:
createdFrom/createdTo-- ISO 8601 date rangelast-- relative time window (e.g.,"6m","10d","24h")term-- full-text search by title or contentallTags/anyTag-- filter by tags (cannot combine both)featureId,companyId,ownerEmail,source-- entity filterspageLimit(max 100) /pageCursor-- pagination
2. Browse and Retrieve Features
List all features/subfeatures and retrieve detailed information.
Tools: PRODUCTBOARDLISTFEATURES, PRODUCTBOARDRETRIEVEFEATURE
List the first 50 features in Productboard, then get details on feature abc-def-123
PRODUCTBOARDLISTFEATURESsupportspageLimit(default 100) andpageOffsetfor paginationPRODUCTBOARDRETRIEVEFEATURErequires featureid(UUID) to get complete details
3. Objectives and Key Results (OKRs)
List objectives, view feature-objective links, and browse key results.
Tools: PRODUCTBOARDLISTOBJECTIVES, PRODUCTBOARDLISTFEATUREOBJECTIVES, PRODUCTBOARDLISTKEYRESULTS
Show me all in-progress objectives owned by [email protected]
Key parameters for PRODUCTBOARDLISTOBJECTIVES:
status.name-- filter by status (e.g.,"In Progress")owner.email-- filter by owner emailparent.id-- filter by parent objectivearchived-- filter by archived state
PRODUCTBOARDLISTFEATURE_OBJECTIVES:
- Requires
id(UUID) of a top-level feature (not subfeatures) - Supports
pageCursorfor pagination
4. Component Management
List product components for organizing features and the product hierarchy.
Tool: PRODUCTBOARDLISTCOMPONENTS
List all components in our Productboard workspace
- Supports
pagelimitandpageoffsetfor pagination - Follow
links.nextfor additional pages
5. Release Tracking
View feature-release assignments with state and date filters.
Tool: PRODUCTBOARDLISTFEATURERELEASEASSIGNMENTS
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.fromandrelease.timeframe.endDate.to(YYYY-MM-DD)
6. Link Notes to Features
Connect customer feedback notes to product features for insight aggregation.
Tool: PRODUCTBOARDCREATENOTE_LINK
Link note 3fa85f64-5717 to feature 1b6c8c76-8f5d for tracking
- Requires
noteId(UUID) andentityId(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:
PRODUCTBOARDLISTFEATUREOBJECTIVESonly works with top-level feature IDs, not subfeature IDs. UsePRODUCTBOARDLIST_FEATURESto identify which features are top-level. - Tag filter exclusivity:
allTagsandanyTagcannot be combined inPRODUCTBOARDLISTNOTES. Choose one filter strategy per query. - Relative vs. absolute dates: The
lastparameter (e.g.,"24h") cannot be combined withcreatedFrom/createdToinPRODUCTBOARDLISTNOTES. Use one approach, not both. - Cursor-based pagination: Follow
links.nextor usepageCursorfrom responses for multi-page results. Offset-based and cursor-based pagination are used on different endpoints -- check each tool. - Note attribution: Either
user.emailorcustomeremailmust be provided inPRODUCTBOARDCREATE_NOTEto attribute feedback. Without