Aha.io
Search, read and update Aha.io ideas, features, epics, releases, goals and comments
Connector by cedricziel · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install connector/cedricziel-aha-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 9 read · 27 write · 11 delete
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 47
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
aha_list_commentsaha_list_key_resultsaha_list_release_epicsaha_list_release_featuresaha_searchget_server_configserver_health_checkserver_statustest_configuration
Write 27 · Create, change, send or run things.
aha_associate_feature_with_epicaha_create_commentaha_create_competitoraha_create_epic_in_productaha_create_epic_in_releaseaha_create_featureaha_create_feature_commentaha_create_goalaha_create_ideaaha_create_idea_by_portal_useraha_create_idea_portal_commentaha_create_idea_with_category
Show 15 more tools
aha_create_idea_with_portal_settingsaha_create_idea_with_scoreaha_create_initiative_in_productaha_create_key_resultaha_move_feature_to_releaseaha_update_competitoraha_update_epicaha_update_featureaha_update_feature_custom_fieldsaha_update_feature_progressaha_update_feature_scoreaha_update_goalaha_update_ideaaha_update_key_resultconfigure_server
Delete 11 · Delete, drop, revoke or wipe things.
aha_associate_feature_with_goalsaha_delete_commentaha_delete_competitoraha_delete_epicaha_delete_featureaha_delete_goalaha_delete_ideaaha_delete_idea_portal_commentaha_delete_key_resultaha_update_commentaha_update_feature_tags
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
AHA_TOKEN
Other settings (environment variables or headers).
AHA_COMPANY
Network hosts it talks to 3
api.anthropic.com· found in codegithub.com· found in install command, coderaw.githubusercontent.com· found in code
Files it touches
- Your home directory (~)
Tools (47)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
aha_associate_feature_with_epicAssociate feature with epicAssociate a feature with an epic in Aha.io. Returns the updated feature and a link to it.
aha_associate_feature_with_goalsSet feature goalscan change or delete dataAssociate a feature with multiple goals in Aha.io. Replaces the feature's whole goal set, so goals left out are unlinked. Returns the updated feature and a link to it.
aha_create_commentAdd commentAdd a comment to an Aha.io record - feature, idea, epic, initiative, goal, release, release phase, requirement or todo. The comment is internal: visible to Aha.io users and never shown in an ideas portal, including on an idea. To reply to a customer in the ideas portal, use aha_create_idea_portal_comment instead. Returns the created comment and a link to the record it was added to. For formatting, send raw HTML in body, e.g. <p>A <strong>formatted</strong> reply.</p>. Do not escape tags as <p> or wrap the body in a Markdown code fence. Plain text also works; Markdown is not converted. Th…
aha_create_competitorCreate competitorCreate a competitor in a product in Aha.io. Returns the created competitor and a link to it.
aha_create_epic_in_productCreate epic in productCreate an epic within a specific product in Aha.io. Returns the created epic and a link to it.
aha_create_epic_in_releaseCreate epic in releaseCreate an epic within a specific release in Aha.io. Returns the created epic and a link to it.
aha_create_featureCreate featureCreate a feature within a specific release in Aha.io. Returns the created feature and a link to it.
aha_create_feature_commentCreate feature commentCreate a comment on a feature in Aha.io. Returns the created comment. For formatting, send raw HTML in body, e.g. <p>A <strong>formatted</strong> reply.</p>. Do not escape tags as <p> or wrap the body in a Markdown code fence. Plain text also works; Markdown is not converted. structuredContent retains the body returned by Aha; read it back with aha_list_comments to verify. aha_create_comment does the same for features and every other record type, and aha_list_comments reads them back - prefer those unless you specifically want this one.
aha_create_goalCreate goalCreate a goal (an objective) in a workspace in Aha.io. Goals are workspace-scoped, so the goal lands in the workspace named by productId. Add its key results afterwards with aha_create_key_result. Returns the created goal and a link to it.
aha_create_ideaCreate ideaCreate an idea in a product in Aha.io. Returns the created idea and a link to it.
aha_create_idea_by_portal_userCreate idea as portal userCreate an idea in a product in Aha.io, attributed to an ideas-portal user rather than to the API token's owner. Returns the created idea and a link to it.
aha_create_idea_portal_commentReply in ideas portalComment on an idea in a way that can be seen outside Aha.io, in the ideas portal - this is how you reply to a customer who submitted or commented on an idea. visibility is required and decides the audience: 'public' shows the comment to every portal user, 'employee_or_creator' restricts it to employees and the idea's creator. Aha.io itself defaults to 'public', so nothing here is optional by design. For a note that must stay inside Aha.io, use aha_create_comment. Returns the created comment and a link to the idea. For formatting, send raw HTML in body, e.g. <p>A <strong>formatted</strong> repl…
aha_create_idea_with_categoryCreate idea with categoryCreate an idea with a category in a product in Aha.io. Returns the created idea and a link to it.
aha_create_idea_with_portal_settingsCreate idea with portal settingsCreate an idea in a product in Aha.io with ideas-portal settings, category and score in one call. Returns the created idea and a link to it.
aha_create_idea_with_scoreCreate idea with scoreCreate an idea with a score in a product in Aha.io. Returns the created idea and a link to it.
Show 32 more tools
aha_create_initiative_in_productCreate initiative in productCreate an initiative within a specific product in Aha.io. Returns the created initiative and a link to it.
aha_create_key_resultCreate key resultCreate a key result under a goal in Aha.io - the measurable half of an OKR. Aha documents name, description, workflow_status, current_metric, assigned_to_user and watchers for creation; if a starting or target metric does not come back set, follow with aha_update_key_result, which documents those. Returns the created key result and a link to it.
aha_delete_commentDelete internal commentcan change or delete dataPermanently delete an internal Aha.io comment by its numeric comment id. This cannot delete an ideas-portal comment; use aha_delete_idea_portal_comment for that distinct, customer-visible stream.
aha_delete_competitorDelete competitorcan change or delete dataDelete a competitor in Aha.io. Returns a confirmation naming the deleted competitor; there is no record to return.
aha_delete_epicDelete epiccan change or delete dataDelete an epic in Aha.io. Returns a confirmation naming the deleted epic; there is no record to return.
aha_delete_featureDelete featurecan change or delete dataDelete a feature in Aha.io. Returns a confirmation naming the deleted feature; there is no record to return.
aha_delete_goalDelete goalcan change or delete dataDelete a goal in Aha.io, along with the key results it owns. Aha only offers this workspace-scoped, so productId is required; aha_get_goal returns it as product_id. Returns a confirmation naming the deleted goal; there is no record to return.
aha_delete_ideaDelete ideacan change or delete dataDelete an idea in Aha.io. Returns a confirmation naming the deleted idea; there is no record to return.
aha_delete_idea_portal_commentDelete ideas-portal commentcan change or delete dataPermanently delete a comment from an idea's customer-visible portal conversation. This uses the ideas-portal comment endpoint, which requires both the parent idea and the numeric comment id. For an internal comment, use aha_delete_comment instead.
aha_delete_key_resultDelete key resultcan change or delete dataDelete a key result in Aha.io. Returns a confirmation naming the deleted key result; there is no record to return.
aha_list_commentsList commentsread-onlyRead the comments on an Aha.io record - feature, idea, epic, initiative, goal, release, release phase, requirement, todo or product. For an idea this returns both streams: internal comments and the ideas-portal conversation, which are separate records in Aha, so a customer's own words arrive alongside internal discussion. Every comment is labelled with its source ('internal' or 'portal') and, for portal comments, its visibility. Returns the comments oldest first as structuredContent, a summary listing each comment id, author and an excerpt, and a link to the parent record. Use the id with the …
aha_list_key_resultsList key resultsread-onlyList the key results belonging to a goal in Aha.io. This is how you get the id of a key result before updating it: aha_search cannot return a key result's metrics or status, and the abbreviated copies inside a goal are not the full records. Returns each key result with its status, progress and metrics, plus a link per key result.
aha_list_release_epicsList epics in a releaseread-onlyDescription is built at runtime.
aha_list_release_featuresList features in a releaseread-onlyDescription is built at runtime.
aha_move_feature_to_releaseMove feature to releaseMove a feature to a different release in Aha.io. Returns the updated feature and a link to it.
aha_searchSearch Aha.ioread-onlySearch across Aha.io records - ideas, features, epics, initiatives, goals, key results, requirements, releases, tasks, pages, comments and more. Queries Aha.io directly, so results are always current. Supports 'term*' for prefix matching, AND/OR/NOT, and "quoted phrases". There is no match-all query: '*' is rejected, because Aha.io returns nothing for it once workspaceId is set. Returns each hit's name, type, reference number and absolute Aha.io URL, already rendered as markdown links, plus paging counts. Idea hits also carry portal vote and endorsement counts, and scorable types their Aha.io …
aha_update_commentUpdate internal commentcan change or delete dataReplace the body of an internal Aha.io comment by its numeric comment id. Use aha_list_comments first to find the id and confirm source is internal. For formatting, send raw HTML in body, e.g. <p>A <strong>formatted</strong> reply.</p>. Do not escape tags as <p> or wrap the body in a Markdown code fence. Plain text also works; Markdown is not converted. The text preview strips tags; structuredContent retains the body returned by Aha. Read it back with aha_list_comments to verify. This endpoint does not edit ideas-portal comments, whose API only supports moderation fields.
aha_update_competitorUpdate competitorUpdate a competitor in Aha.io. Returns the updated competitor and a link to it.
aha_update_epicUpdate epicUpdate an epic's name or description in Aha.io. Returns the updated epic and a link to it.
aha_update_featureUpdate featureUpdate a feature's name or description in Aha.io. Returns the updated feature and a link to it.
aha_update_feature_custom_fieldsUpdate feature custom fieldsUpdate a feature's custom fields in Aha.io. Returns the updated feature and a link to it.
aha_update_feature_progressUpdate feature progressUpdate a feature's progress percentage in Aha.io. Returns the updated feature and a link to it.
aha_update_feature_scoreUpdate feature scoreUpdate a feature's score in Aha.io. Returns the updated feature and a link to it.
aha_update_feature_tagsSet feature tagscan change or delete dataUpdate tags for a feature in Aha.io. Replaces the feature's whole tag set, so tags left out are removed. Returns the updated feature and a link to it.
aha_update_goalUpdate goalUpdate a goal in Aha.io - its name, description, success metric, status, time frame or progress. Only the fields you send change. Read the goal first with aha_get_goal: a goal's status lives under success_metric.workflow_status, and progress is only writable when progress_source is progress_manual. Returns the updated goal and a link to it.
aha_update_ideaUpdate ideaUpdate an idea in Aha.io, including its workflow status, name, description, assignee, or custom fields. Only the fields you send change. Read the idea first with aha_get_idea because workflow statuses are workspace-specific. Returns the updated idea and a link to it.
aha_update_key_resultUpdate key resultUpdate a key result in Aha.io - its status, its starting, current or target metric, its name or description. This is how an OKR gets re-graded: move current_metric and set workflow_status. Only the fields you send change; read the key result first with aha_get_key_result. Returns the updated key result and a link to it.
configure_serverConfigure serverConfigure server settings (company, token, mode)
get_server_configGet server configurationread-onlyGet current server configuration
server_health_checkCheck server healthread-onlyGet server health status and diagnostics
server_statusGet server statusread-onlyGet detailed server status and configuration
test_configurationTest Aha.io configurationread-onlyTest current Aha.io configuration
Signals
- Stars
- 6
- Forks
- 2
- Open issues
- 2
- Weekly downloads
- 36
- Last commit
- Oct 22, 2026 (7 days ago)
- Last release
- Sep 21, 2026 (1 month ago)
- Last package publish
- Sep 21, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.cedricziel/aha-mcp- Version
- 5.2.0
- Auth
- API key
- Packages
- npm @cedricziel/aha-mcpoci
ghcr.io/cedricziel/aha-mcp:5.2.0mcpb https://github.com/cedricziel/aha-mcp/releases/download/aha-mcp-v5.2.0/aha-mcp-v5.2.0.mcpb - License
- MIT
- Repository
- github.com/cedricziel/aha-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from cedricziel
- 0.582score
observability
cedricziel
Practical observability guide for this workspace.
SkillBFreshness: B★ 6Claude Code +9 - 0.532score
coding-agent
cedricziel
Run coding agents (Claude Code, Codex, OpenCode, or others) as background processes for programmatic control.
SkillCFreshness: C★ 6Claude Code +9 - 0.532score
e2e-testing
cedricziel
Playwright visual regression testing for the assistant Flutter SPA.
SkillCFreshness: C★ 6Claude Code +9 - 0.532score
ios-codesigning
cedricziel
iOS code signing and provisioning profile management via fastlane match.
SkillCFreshness: C★ 6Claude Code +9 - 0.532score
interface-implementation
cedricziel
Checklist and architectural rules for implementing new assistant interfaces (CLI, Slack, web, etc.).
SkillCFreshness: C★ 6Claude Code +9 - 0.532score
openapi-sync
cedricziel
Enforces OpenAPI spec discipline when working on REST API endpoints in this project.
SkillCFreshness: C★ 6Claude Code +9
Cite this page
Aha.io MCP server. Agent Mart. https://agentmart.dev/connectors/cedricziel-aha-mcp (last updated 2026-10-25)