Aha Io MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Aha.io's product management platform. Features offline database synchronization, vector embeddings for semantic search, and comprehensive workflow automation. Its 40 documented tools cover aha, feature, idea, epic. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 6 · #129 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Aha Io

before you install - you'll need

Set AHA_COMPANY, AHA_TOKEN before connecting. MCP_AUTH_TOKEN is optional or environment-specific per the README.

Claude Code

claude mcp add cedricziel-aha-mcp -- npx -y @cedricziel/aha-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cedricziel-aha-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cedricziel/aha-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem · Claude Desktop extension (.mcpb bundle)

license MIT - declared in the repository

npm package @cedricziel/aha-mcp - published under the repo owner's npm scope (@cedricziel)

registry namespace io.github.cedricziel is GitHub-verified and matches the repo owner

03 · What Aha Io can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can read one feature, including workflow status, release, assignee, tags, score and custom field values, read one epic, read one idea, and read one initiative.

The 40 tools it gives your agent

Extracted from the project's README - what Aha.io lets an agent do.

aha_get_feature: - Read one feature, including workflow status, release, assignee, tags, score and custom field values
aha_get_epic: - Read one epic
aha_get_idea: - Read one idea
aha_get_initiative: - Read one initiative
aha_get_release: - Read one release
aha_get_goal: - Read one goal, including its time frame, progress source, success metric and key result summary
aha_get_key_result: - Read one key result, including its status and starting, current and target metrics
aha_list_release_features: - List the features assigned to a release, with a link per feature and Aha's total for the release
aha_list_release_epics: - List the epics assigned to a release, with a link per epic and Aha's total for the release
aha_list_key_results: - List a goal's key results, with status, progress and metrics
aha_list_comments: - List the comments on a record, both streams for an idea
aha_create_feature_comment: - Create a comment on a feature

show all 40 tools

aha_create_initiative_in_product: - Create an initiative within a specific product
aha_create_feature: - Create a feature within a specific release
aha_update_feature: - Update a feature
aha_delete_feature: - Delete a feature
aha_update_feature_progress: - Update a feature's progress
aha_update_feature_score: - Update a feature's score
aha_update_feature_custom_fields: - Update a feature's custom fields
aha_update_epic: - Update an epic
aha_delete_epic: - Delete an epic
aha_create_epic_in_product: - Create an epic within a specific product
aha_create_epic_in_release: - Create an epic within a specific release
aha_create_idea: - Create an idea in a product
aha_create_idea_with_category: - Create an idea with a category
aha_create_idea_with_score: - Create an idea with a score
aha_delete_idea: - Delete an idea
aha_create_goal: - Create a goal (objective) in a workspace
aha_update_goal: - Update a goal's name, description, success metric, status, time frame or progress
aha_delete_goal: - Delete a goal, and with it the key results it owns
aha_create_key_result: - Create a key result under a goal
aha_update_key_result: - Update a key result - its status and starting, current or target metric
aha_delete_key_result: - Delete a key result
aha_create_competitor: - Create a competitor in a product
aha_update_competitor: - Update a competitor
aha_delete_competitor: - Delete a competitor
aha_create_idea_by_portal_user: - Create an idea by a portal user
aha_create_idea_with_portal_settings: - Create an idea with enhanced portal settings
aha_associate_feature_with_epic: - Associate a feature with an epic
aha_move_feature_to_release: - Move a feature to a different release

Latest releases

aha-mcp-v5.2.0 · 2026-08-13

5.2.0 (2026-08-13) · carry reference numbers, votes and links on search hits

aha-mcp-v5.1.0 · 2026-08-12

5.1.0 (2026-08-12) · enumerate a release's epics as a tool · enumerate a release's features as a tool · publish to the official MCP Registry

aha-mcp-v5.0.1 · 2026-08-12

5.0.1 (2026-08-12) · advertise tool output schemas in JSON Schema 2020-12

04 · Who maintains Aha Io

Aha.io is maintained by cedricziel. We track 2 MCP servers from cedricziel - 2 actively maintained, 7 combined GitHub stars, oldest repo from Mar 2025.

05 · Facts

repository: github.com/cedricziel/aha-mcp
website: https://github.com/cedricziel/aha-mcp#readme
category: other - ranked #129 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 9 releases in the last 90 days (latest 2026-08-13)
registry: io.github.cedricziel/aha-mcp (active, first published 2026-08-12 · 2 versions)
packages: npm:@cedricziel/aha-mcp · oci:ghcr.io/cedricziel/aha-mcp:5.2.0 · mcpb:https://github.com/cedricziel/aha-mcp/releases/download/aha-mcp-v5.2.0/aha-mcp-v5.2.0.mcpb

06 · Aha Io FAQ

Is Aha Io still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 9 releases in the last 90 days. We re-verify nightly.

What can Aha Io do?

With this server connected, an agent can read one feature, including workflow status, release, assignee, tags, score and custom field values, read one epic, read one idea, and read one initiative.

How do I install Aha Io?

Run `npx -y @cedricziel/aha-mcp`. The README documents 3 environment variables (AHA_COMPANY, AHA_TOKEN, MCP_AUTH_TOKEN) to set first. Set AHA_COMPANY, AHA_TOKEN before connecting. MCP_AUTH_TOKEN is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Aha Io run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Aha Io

Alternatives to Aha Io

Maintained other servers if Aha Io isn't the fit.

More MCP servers to compare · Celigo · Channel3 Shopping · Posokanei MCP · Jupyter MCP Server · Ennodia

More TypeScript MCP servers · Agent^rider · Weapp Agent MCP · Archlang MCP · see all