How to connect Aha! to Claude

Connect Claude Web, Desktop and Cowork to Aha! MCP. List recently created ideas in aha!, create a release for the next quarter, and more using natural language, with authentication handled for you.

Aha! logoAha!
Oauth2

Aha! is a product management platform for setting strategy, prioritizing ideas, and planning roadmaps. It helps product teams align goals with development work and make better decisions.

110 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Aha! account to Claude via Composio Connect, enabling it to list recently created ideas in Aha!, create a release for the next quarter, update roadmap features with priority scores, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Aha! with

Connecting Aha! to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Aha! account

Back in Claude, ask it to connect to Aha! or give it any Aha!-related task.

For example, ask Claude to:

  • "List recently created ideas in Aha!"
  • "Create a release for the next quarter"
  • "Update roadmap features with priority scores"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Aha! account is ready to use.

What is the Aha! Claude Connector, and what's possible with it?

The Aha! MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Aha! account. It provides structured and secure access so your agent can perform Aha! operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Aha!?

The connector can show as connected, but Claude must use it in each Aha! conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Aha! again.

2. Why does Claude show an MCP server error before Aha! connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Aha!.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Aha!.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Aha! authorization link not work?

The Composio connector is one server. Your Aha! account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Aha! connection.
  • Composio creates a fresh Aha! authorization link.
  • Open that link in your browser and finish the Aha! sign-in.

4. Why do Aha! actions fail after they worked before?

The Aha! connection can expire or lose permission.

  • Ask Claude to inspect the Aha! connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Aha! account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Aha!.
  • If the action still fails with a permission error, check that the connected account has that permission in Aha! itself.

5. How do I switch to a different Aha! account?

Claude can manage the Aha! connection for you.

  • Ask Claude to disconnect or delete the current Aha! account.
  • Ask Claude to connect Aha! again.
  • Open the new Composio authorization link for Aha!.
  • Sign in with the other Aha! account in the browser.
  • After the account connects, ask Claude to retry the Aha! task.

6. Why is my Aha! connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Aha! connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Aha! tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Aha!.
TOOLS

Supported Tools

Every Aha! action and event your agent gets out of the box.

Add Product Idea Portals

Add idea portal links to a product without replacing existing links.

Convert Feature to Epic

Irreversibly convert an existing feature into an epic while preserving its data and relationships.

Convert Requirement to Feature

Irreversibly convert an existing requirement into a feature.

Create Custom Field Option

Create an option for one custom-field definition.

Create Epic

Create an epic in a release or in a workspace's default release.

Create Feature

Create a feature in a release with its documented planning fields.

Create Goal

Create a strategic goal in one Aha!

Create Idea

Create an idea in a product with the documented idea fields.

Create Idea Theme

Create an idea theme in a product.

Create Initiative

Create a strategic initiative in one Aha!

Create Key Result

Create a key result under one strategic goal.

Create Parking-Lot Release

Create a parking-lot release in a workspace.

Create Product

Create an Aha!

Create Product Contributor

Create an Aha!

Create Product Roll-Up Release

Create a roll-up release in a product line, optionally adding workspaces.

Create Release Milestone

Create a phase or milestone in an Aha!

Create Requirement

Create a requirement within one feature.

Create To-Do

Create a standalone personal to-do for the connected Aha!

Create Workflow Status Time

Create a workflow status interval for one supported parent record.

Delete Custom Field Option

Delete one option from an Aha!

Delete Epic

Delete an epic by ID; it may remain restorable through the recycle bin for up to 30 days.

Delete Feature

Delete one feature by ID or reference number; it may remain restorable through the recycle bin for up to 30 days.

Delete Goal

Delete one strategic goal; it may remain restorable through the recycle bin for up to 30 days.

Delete Idea

Delete an idea by ID or reference key; it may remain restorable through the recycle bin for up to 30 days.

Delete Idea Theme

Delete an idea theme by numeric ID; it may remain restorable through the recycle bin for up to 30 days.

Delete Initiative

Delete one strategic initiative; it may remain restorable through the recycle bin for up to 30 days.

Delete Key Result

Delete one key result; it may remain restorable through the recycle bin for up to 30 days.

Delete Release

Delete a release from a workspace; it may remain restorable through the recycle bin for up to 30 days.

Delete Release Phase

Delete a release phase by numeric ID; it may remain restorable through the recycle bin for up to 30 days.

Delete Requirement

Delete one requirement by ID or reference number; it may remain restorable through the recycle bin for up to 30 days.

Delete To-Do

Delete one to-do by its Aha!

Delete User Custom Role

Remove a user's custom role in one Aha!

Delete User Product Role

Remove a user's role in one Aha!

Delete Workflow Status Time

Delete a workflow status interval.

Duplicate Release

Create a duplicate of an existing release.

Get Current User

Return the connected Aha!

Get Custom Layout

Return one custom layout.

Get Epic

Return one Aha!

Get Feature

Return detailed information for one feature by internal ID or human-readable reference number.

Get Goal

Return one strategic goal by ID or reference number.

Get Idea

Return one idea by ID or reference number.

Get Idea Theme

Return one idea theme by ID.

Get Identity Provider

Return one identity provider configured for account SSO.

Get Initiative

Return one strategic initiative by ID or reference number.

Get Key Result

Return one key result by ID.

Get Release

Return one release by ID or reference number.

Get Release Phase

Return one release phase by ID.

Get Requirement

Return one requirement by ID or reference number.

Get Roll-Up Release

Return one roll-up release by ID or reference number.

Get Strategic Model

Return one strategic model by ID.

Get Strategic Vision

Return one strategic vision by ID.

Get To-Do

Return one to-do by its Aha!

Get User

Get a specific Aha!

Get Workflow

Return one workflow with its statuses and workflow kinds.

Get Workflow Status Time

Return one workflow status interval.

Get Workspace

Return one workspace and its applied template by ID.

List All Custom Field Options

Return all options configured for one custom-field definition.

List Assigned Records

List one page of records assigned to the connected Aha!

List Assistant Usage

Return one page of per-user AI assistant activity.

List Audits

Return one page of immutable Aha!

List Child Releases

Return releases under a roll-up release, one page at a time.

List Custom Field Options

Return selectable options for one custom-field definition.

List Custom Fields

Return custom-field definitions, keys, types, and worksheet metadata.

List Custom Layouts

Return custom layouts configured in the account.

List Deletions

Return records currently visible in the account recycle bin, one page at a time.

List Epics

Return one page of epics across the account or within a goal, initiative, release, or workspace.

List Features

Return one page of features across the account or within a goal, initiative, epic, workspace, or release.

List Goals

Return one page of strategic goals across the account or within an initiative or product.

List Idea Portals

Return idea portals configured in the account or linked to one product, one page at a time.

List Ideas

Search and filter ideas across the account or within one product, returning one page at a time.

List Idea Themes

Return idea themes across the account, one page at a time.

List Identity Providers

Return active identity providers available for account SSO.

List Initiatives

Return one page of strategic initiatives across the account or within a goal or product.

List Key Results

Return key results for one strategic goal, one page at a time.

List Product Roll-Up Releases

Return roll-up releases in one Aha!

List Product Users

List one page of users and roles associated with an Aha!

List Related Ideas

Find ideas related to a term, one page at a time.

List Release Phases

Return release phases across the account or within one release, one page at a time.

List Releases

Return releases associated with a workspace, goal, or initiative, one page at a time.

List Requirements

Return requirements for one feature, optionally updated since a timestamp, one page at a time.

List Strategy Models

Return strategy models configured in the account, one page at a time.

List Strategy Visions

Return strategic vision records in the account, one page at a time.

List To-Dos

Return one page of account, assigned-user, or associated-record to-dos.

List User Custom Roles

List one page of an Aha!

List User Product Roles

List one page of an Aha!

List Users

Return account users and their seat and administrator flags, one page at a time.

List Workflows

Return workflows and statuses configured for one workspace.

List Workflow Status Times

Return workflow status intervals for one supported parent record, one page at a time.

List Workspaces

Return Aha!

Promote Idea

Promote an idea to an epic, feature, initiative, or requirement.

Replace Product Idea Portals

Replace every idea portal link on a product.

Restore Deleted Record

Start restoring a record from the recycle bin within its retention period; restoration may continue asynchronously.

Update Custom Field Option

Update the value, color, or visibility of a custom-field option.

Update Epic

Update an epic by ID; provide at least one field to change.

Update Feature

Update one feature's planning fields; provide at least one field to change.

Update Goal

Update one strategic goal; provide at least one field to change.

Update Idea

Update an existing idea; provide at least one field to change.

Update Idea Theme

Update an idea theme; provide a new name or description.

Update Initiative

Update one strategic initiative; provide at least one field to change.

Update Key Result

Update one key result; provide at least one field to change.

Update Product

Update an Aha!

Update Release

Update a release by ID, optionally through a specified workspace, including dates, capacity, progress, parent, owner, goals, and initiatives; provide at least one field to change.

Update Release Phase

Update a release phase's type, dates, description, or progress.

Update Requirement

Update one requirement; provide at least one field to change.

Update Roll-Up Release

Update a roll-up release or add workspaces to it.

Update To-Do

Update an existing to-do's name or description; provide at least one of name or body.

Update User

Update an Aha!

Update User Custom Roles

Assign a custom role to an Aha!

Update User Product Roles

Assign a product role to an Aha!

Update Workflow Status Time

Update a workflow status interval.

FAQ

Frequently asked questions

With a standalone Aha! MCP server, the agents and LLMs can only access a fixed set of Aha! tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Aha! and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Aha! tools.

Yes, absolutely. You can configure which Aha! scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Aha! data and credentials are handled as safely as possible.

Start with Aha!.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Aha! tool your agent needs.Free to start.

Start building