Integration

Aha! integration

Aha! is a product development platform for roadmaps, ideas and delivery. Through its API v3 an agent can list, read, create, update and delete features, epics, requirements, tasks (to-dos), comments, releases, release phases, iterations, initiatives, goals, key results, competitors, personas, tags, workspaces, custom field definitions and options, automations and their actions, and discovery studies and interviews, and read ideas, idea portals, portal and idea users, proxy votes, idea organizations, program increments, applications, users and strategy records. Lists filter with filter.<operator>[field] objects and page with a cursor (after, per_page up to 200). Not exposed: the API v1-only operations (creating ideas, votes or attachments), the PUT twin of each update (the PATCH tool sends the same body) and the annotation list (it needs an owner the spec does not let a caller pass). Authentication is an Aha! API key (Settings, Personal, Developer, API key) sent as a Bearer token; it acts with the permissions of the user who created it.

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Aha!.Built from the 132 Aha! tools below, on the connection you add once.

What you can do with Aha!

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Each badge shows the default agent permission of an endpoint (allowed: an agent calls it without asking; ask first: you are asked before an agent calls it, when the agent or chat asks permission for sensitive actions; never: no agent may call it), which every user can change endpoint by endpoint in their credential settings.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Automation, 5 operations

  • create_automationCreate automationPOSTAgents: ask firstCreates an automation in Aha! and returns it. Required: trigger_record_type. Once enabled, it runs its actions (updating records, creating comments or to-dos, sending email) by itself whenever its trigger fires.
  • delete_automationDelete automationDELETEAgents: ask firstDeletes an automation.
  • get_automationGet automationGETAgents: ask firstReturns one automation by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_automationsList automationsGETAgents: ask firstLists automations in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_automationUpdate automationPATCHAgents: ask firstUpdates an automation: only the fields you send change. Leave out a field to keep its value. Enabling an automation makes it run its actions by itself whenever its trigger fires.

Automation action, 5 operations

  • create_automation_actionCreate automation actionPOSTAgents: ask firstCreates an automation action in Aha! and returns it. Required: automation_id, type. A send_email action emails real people each time the automation fires; send_to_integration sends records to an integration.
  • delete_automation_actionDelete automation actionDELETEAgents: ask firstDeletes an automation action.
  • get_automation_actionGet automation actionGETAgents: ask firstReturns one automation action by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_automation_actionsList automation actionsGETAgents: ask firstLists automation actions in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_automation_actionUpdate automation actionPATCHAgents: ask firstUpdates an automation action: only the fields you send change. Leave out a field to keep its value. A send_email action emails real people each time the automation fires.

Comment, 5 operations

  • create_commentCreate commentPOSTAgents: ask firstCreates a comment in Aha! and returns it. Required: body, record_id, record_type. Attach it to a record with record_type and record_id; reply to a comment with parent_id.
  • delete_commentDelete commentDELETEAgents: ask firstDeletes a comment.
  • get_commentGet commentGETAgents: ask firstReturns one comment by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_commentsList commentsGETAgents: ask firstLists comments in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_commentUpdate commentPATCHAgents: ask firstUpdates a comment: only the fields you send change. Leave out a field to keep its value.

Competitor, 5 operations

  • create_competitorCreate competitorPOSTAgents: ask firstCreates a competitor in Aha! and returns it. Required: project_id.
  • delete_competitorDelete competitorDELETEAgents: ask firstDeletes a competitor.
  • get_competitorGet competitorGETAgents: ask firstReturns one competitor by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_competitorsList competitorsGETAgents: ask firstLists competitors in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_competitorUpdate competitorPATCHAgents: ask firstUpdates a competitor: only the fields you send change. Leave out a field to keep its value.

Custom field option, 5 operations

  • create_custom_field_optionCreate custom field optionPOSTAgents: ask firstCreates a custom field option in Aha! and returns it. Required: name, custom_field_definition_id.
  • delete_custom_field_optionDelete custom field optionDELETEAgents: ask firstDeletes a custom field option.
  • get_custom_field_optionGet custom field optionGETAgents: ask firstReturns one custom field option by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_custom_field_optionsList custom field optionsGETAgents: ask firstLists custom field options in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_custom_field_optionUpdate custom field optionPATCHAgents: ask firstUpdates a custom field option: only the fields you send change. Leave out a field to keep its value.

Discovery interview, 5 operations

  • create_discovery_interviewCreate discovery interviewPOSTAgents: ask firstCreates a discovery interview in Aha! and returns it. Required: name.
  • delete_discovery_interviewDelete discovery interviewDELETEAgents: ask firstDeletes a discovery interview.
  • get_discovery_interviewGet discovery interviewGETAgents: ask firstReturns one discovery interview by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_discovery_interviewsList discovery interviewsGETAgents: ask firstLists discovery interviews in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_discovery_interviewUpdate discovery interviewPATCHAgents: ask firstUpdates a discovery interview: only the fields you send change. Leave out a field to keep its value.

Discovery study, 5 operations

  • create_discovery_studyCreate discovery studyPOSTAgents: ask firstCreates a discovery study in Aha! and returns it. Required: name, project_id.
  • delete_discovery_studyDelete discovery studyDELETEAgents: ask firstDeletes a discovery study.
  • get_discovery_studyGet discovery studyGETAgents: ask firstReturns one discovery study by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_discovery_studiesList discovery studiesGETAgents: ask firstLists discovery studies in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_discovery_studyUpdate discovery studyPATCHAgents: ask firstUpdates a discovery study: only the fields you send change. Leave out a field to keep its value.

Epic, 5 operations

  • create_epicCreate epicPOSTAgents: ask firstCreates an epic in Aha! and returns it.
  • delete_epicDelete epicDELETEAgents: ask firstDeletes an epic.
  • get_epicGet epicGETAgents: ask firstReturns one epic by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_epicsList epicsGETAgents: ask firstLists epics in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_epicUpdate epicPATCHAgents: ask firstUpdates an epic: only the fields you send change. List fields (tags, watchers and the like) are merged: an item adds, an item with _destroy: true removes.

Custom field definition, 4 operations

  • create_custom_field_definitionCreate custom field definitionPOSTAgents: ask firstCreates a custom field definition in Aha! and returns it. Required: name, key, type, record_type.
  • get_custom_field_definitionGet custom field definitionGETAgents: ask firstReturns one custom field definition by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_custom_field_definitionsList custom field definitionsGETAgents: ask firstLists custom field definitions in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.
  • update_custom_field_definitionUpdate custom field definitionPATCHAgents: ask firstUpdates a custom field definition: only the fields you send change. List fields (tags, watchers and the like) are merged: an item adds, an item with _destroy: true removes.

Feature, 4 operations

  • create_featureCreate featurePOSTAgents: ask firstCreates a feature in Aha! and returns it.
  • delete_featureDelete featureDELETEAgents: ask firstDeletes a feature.
  • get_featureGet featureGETAgents: ask firstReturns one feature by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_featuresList featuresGETAgents: ask firstLists features in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Goal, 4 operations

  • create_goalCreate goalPOSTAgents: ask firstCreates a goal in Aha! and returns it. Required: project_id.
  • delete_goalDelete goalDELETEAgents: ask firstDeletes a goal.
  • get_goalGet goalGETAgents: ask firstReturns one goal by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_goalsList goalsGETAgents: ask firstLists goals in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Initiative, 4 operations

  • create_initiativeCreate initiativePOSTAgents: ask firstCreates an initiative in Aha! and returns it. Required: project_id.
  • delete_initiativeDelete initiativeDELETEAgents: ask firstDeletes an initiative.
  • get_initiativeGet initiativeGETAgents: ask firstReturns one initiative by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_initiativesList initiativesGETAgents: ask firstLists initiatives in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Iteration, 4 operations

  • create_iterationCreate iterationPOSTAgents: ask firstCreates an iteration in Aha! and returns it. Required: project_id.
  • delete_iterationDelete iterationDELETEAgents: ask firstDeletes an iteration.
  • get_iterationGet iterationGETAgents: ask firstReturns one iteration by id or reference number with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_iterationsList iterationsGETAgents: ask firstLists iterations in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Key result, 4 operations

  • create_key_resultCreate key resultPOSTAgents: ask firstCreates a key result in Aha! and returns it. Required: goal_id.
  • delete_key_resultDelete key resultDELETEAgents: ask firstDeletes a key result.
  • get_key_resultGet key resultGETAgents: ask firstReturns one key result by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields). Enterprise+ plans only.
  • list_key_resultsList key resultsGETAgents: ask firstLists key results in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after. Enterprise+ plans only.

Persona, 4 operations

  • create_personaCreate personaPOSTAgents: ask firstCreates a persona in Aha! and returns it. Required: project_id.
  • delete_personaDelete personaDELETEAgents: ask firstDeletes a persona.
  • get_personaGet personaGETAgents: ask firstReturns one persona by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_personasList personasGETAgents: ask firstLists personas in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Release, 4 operations

  • create_releaseCreate releasePOSTAgents: ask firstCreates a release in Aha! and returns it. Required: project_id.
  • delete_releaseDelete releaseDELETEAgents: ask firstDeletes a release.
  • get_releaseGet releaseGETAgents: ask firstReturns one release by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_releasesList releasesGETAgents: ask firstLists releases in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Release phase, 4 operations

  • create_release_phaseCreate release phasePOSTAgents: ask firstCreates a release phase in Aha! and returns it. Required: type, release_id.
  • delete_release_phaseDelete release phaseDELETEAgents: ask firstDeletes a release phase.
  • get_release_phaseGet release phaseGETAgents: ask firstReturns one release phase by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_release_phasesList release phasesGETAgents: ask firstLists release phases in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Requirement, 4 operations

  • create_requirementCreate requirementPOSTAgents: ask firstCreates a requirement in Aha! and returns it. Required: feature_id.
  • delete_requirementDelete requirementDELETEAgents: ask firstDeletes a requirement.
  • get_requirementGet requirementGETAgents: ask firstReturns one requirement by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_requirementsList requirementsGETAgents: ask firstLists requirements in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Tag, 4 operations

  • create_tagCreate tagPOSTAgents: ask firstCreates a tag in Aha! and returns it. Required: name.
  • delete_tagDelete tagDELETEAgents: ask firstDeletes a tag.
  • get_tagGet tagGETAgents: ask firstReturns one tag by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_tagsList tagsGETAgents: ask firstLists tags in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Task, 4 operations

  • create_taskCreate taskPOSTAgents: ask firstCreates a task in Aha! and returns it. Tasks are Aha! to-dos: assign one with assigned_to and attach it to a record with record_type and record_id.
  • delete_taskDelete taskDELETEAgents: ask firstDeletes a task.
  • get_taskGet taskGETAgents: ask firstReturns one task by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_tasksList tasksGETAgents: ask firstLists tasks in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Project, 3 operations

  • create_projectCreate projectPOSTAgents: ask firstCreates a workspace in Aha! and returns it. Required: name, reference_prefix.
  • get_projectGet projectGETAgents: ask firstReturns one workspace by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_projectsList projectsGETAgents: ask firstLists workspaces in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Application, 2 operations

  • get_applicationGet applicationGETAgents: ask firstReturns one application by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_applicationsList applicationsGETAgents: ask firstLists applications in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Business model component, 2 operations

  • get_business_model_componentGet business model componentGETAgents: ask firstReturns one business model component by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_business_model_componentsList business model componentsGETAgents: ask firstLists business model components in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Idea, 2 operations

  • get_ideaGet ideaGETAgents: ask firstReturns one idea by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_ideasList ideasGETAgents: ask firstLists ideas in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Idea endorsement, 2 operations

  • get_idea_endorsementGet idea endorsementGETAgents: ask firstReturns one proxy vote by id with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_idea_endorsementsList idea endorsementsGETAgents: ask firstLists proxy votes in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Idea organization, 2 operations

  • get_idea_organizationGet idea organizationGETAgents: ask firstReturns one idea organization by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_idea_organizationsList idea organizationsGETAgents: ask firstLists idea organizations in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Idea portal, 2 operations

  • get_idea_portalGet idea portalGETAgents: ask firstReturns one idea portal by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_idea_portalsList idea portalsGETAgents: ask firstLists idea portals in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Idea user, 2 operations

  • get_idea_userGet idea userGETAgents: ask firstReturns one idea user by id with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields). Personal data of idea portal users (name, email, phone).
  • list_idea_usersList idea usersGETAgents: ask firstLists idea users in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after. Personal data of idea portal users (name, email, phone).

Portal user, 2 operations

  • get_portal_userGet portal userGETAgents: ask firstReturns one portal user by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at). Personal data of idea portal users.
  • list_portal_usersList portal usersGETAgents: ask firstLists portal users in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after. Personal data of idea portal users.

Program increment, 2 operations

  • get_program_incrementGet program incrementGETAgents: ask firstReturns one program increment by id or reference number with its default fields; ask for other fields, related records or custom fields with fields (for example fields=default,custom_fields).
  • list_program_incrementsList program incrementsGETAgents: ask firstLists program increments in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Strategy model, 2 operations

  • get_strategy_modelGet strategy modelGETAgents: ask firstReturns one strategic model by id or reference number with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_strategy_modelsList strategy modelsGETAgents: ask firstLists strategic models in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Strategy position, 2 operations

  • get_strategy_positionGet strategy positionGETAgents: ask firstReturns one positioning by id or reference number with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_strategy_positionsList strategy positionsGETAgents: ask firstLists positioning in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Strategy vision, 2 operations

  • get_strategy_visionGet strategy visionGETAgents: ask firstReturns one strategy vision by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_strategy_visionsList strategy visionsGETAgents: ask firstLists strategy visions in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Strategy vision component, 2 operations

  • get_strategy_vision_componentGet strategy vision componentGETAgents: ask firstReturns one strategy vision component by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).
  • list_strategy_vision_componentsList strategy vision componentsGETAgents: ask firstLists strategy vision components in the Aha! account, newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

Annotation, 1 operation

  • get_annotationGet annotationGETAgents: ask firstReturns one annotation by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at).

Automation log, 1 operation

  • list_automation_messagesList automation messagesGETAgents: ask firstLists the run log of one automation (message, severity, time), newest first. Filter with the filter.* params (objects, AND-combined), sort with sort.asc or sort.desc, page with per_page (max 200) and after.

User, 1 operation

  • get_userGet userGETAgents: ask firstReturns one user by id with its default fields; ask for other fields or related records with fields (for example fields=default,created_at). Personal data (name, email).

Showing the first 120 of 132 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Aha! from Claude Code, Cursor or Codex

Connect Aha! in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Aha! operations become tools the client can call, next to every other integration you connected.

Claude Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Aha!

  1. Create your workspace

    Sign up free. Nothing to install.

  2. Connect Aha! once

    Add your Aha! connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.

  3. Describe the job in chat

    The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Aha! integration FAQ

What can you do with the Aha! integration?

LiveContext exposes 132 operations on Aha!, covering automation, automation action, comment and competitor.

Popular integrations

Browse the whole catalog