How to integrate Aha! MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Aha! account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Aha! with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Aha! with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Aha!

Ask your agent to connect to Aha!, or simply request any Aha!-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Aha! connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Aha! or request any Aha!-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Aha! MCP server, 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.

Way Forward

With Aha! connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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. Hermes 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