Aha MCP server

Connect Aha to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy AhaBook a demo

What you can do with the Aha MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list releases tool in Aha
  • Use the list ideas tool in Aha
  • Use the manage feature tool in Aha
  • Use the list users tool in Aha
  • Use the manage idea tool in Aha
  • Use the manage epic tool in Aha

Supported Tools

list_releases

List Releases

List releases for a given product in Aha!. Returns release names, dates, statuses, and reference numbers. Use this to find a release before creating features within it.

list_ideas

List Ideas

List ideas from Aha!, optionally filtered by product. You can also search ideas by keyword. Returns idea names, reference numbers, statuses, and vote counts.

manage_feature

Manage Feature

Create, update, or delete a feature in Aha!. Features are the core work items that belong to releases. You can set name, description, assignee, dates, tags, and workflow status.

list_users

List Users

List users in your Aha! account. You can filter by email to look up a specific user. Returns user names, emails, and IDs for use in assigning features, ideas, and other records.

manage_idea

Manage Idea

Create, update, or delete an idea in Aha!. Ideas represent customer feedback and feature requests. They can be tagged, categorized, and eventually promoted to features.

manage_epic

Manage Epic

Create, update, or delete an epic in Aha!. Epics are large bodies of work that group multiple features together. They belong to a product and can span multiple releases.

manage_comment

Manage Comment

Create, update, list, or delete comments on Aha! records. Comments can be added to features, epics, ideas, releases, goals, initiatives, requirements, and to-dos.

manage_todo

Manage To-Do

Create, update, list, or delete to-dos on Aha! records. To-dos can be associated with features, releases, requirements, epics, and ideas. They support assignees, due dates, and completion status.

manage_release

Manage Release

Create, update, or delete a release in Aha!. Releases organize features into time-based milestones. You can set dates, descriptions, and parking lot status.

list_products

List Products

List all products (workspaces) in your Aha! account. Returns product names, reference prefixes, and basic configuration. Use this to discover available products before working with features, releases, or other records scoped to a product.

manage_initiative

Manage Initiative

Create, update, or delete a strategic initiative in Aha!. Initiatives link strategy to execution by connecting goals to releases, epics, and features.

list_epics

List Epics

List epics from Aha!, optionally filtered by product or release. Returns epic names, reference numbers, statuses, and progress. Supports pagination.

list_goals_and_initiatives

List Goals & Initiatives

List strategic goals and/or initiatives from Aha!, optionally filtered by product. Returns names, statuses, progress, and reference numbers. Useful for understanding the strategic context of a product.

list_features

List Features

List features from Aha!, optionally filtered by product, release, epic, tag, or assignee. Returns feature names, reference numbers, statuses, and assignment details. Supports pagination.

manage_goal

Manage Goal

Create, update, or delete a strategic goal in Aha!. Goals define measurable outcomes and can have key results (OKRs). They connect strategy to the product roadmap.

get_feature

Get Feature

Retrieve full details of a specific feature by its ID or reference number. Returns the feature's name, description, status, assignee, dates, tags, custom fields, and requirements.

who_am_i

Who Am I

Retrieve the authenticated Aha! user and account subdomain. Use this to confirm which user and account a connection represents.

Connect Aha to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Aha in Metorial. In your Metorial portal, enable the Aha MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Aha tools.

Run Aha through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Aha and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Aha tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Aha

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Aha

Manage product development records in Aha! including features, epics, releases, goals, initiatives, and ideas. Create and update roadmap items, track strategy with goals and OKRs, manage releases and milestones, and organize features by product or epic. Submit and manage ideas through idea portals, including voting, commenting, and promoting ideas to features or epics. Add comments and attachments to records, create to-dos and tasks, track time, manage capacity planning, and link records together. Manage users, teams, custom fields, custom tables, competitors, personas, notes, and knowledge base documents. Configure integrations, retrieve custom reports, and receive webhooks for record activity, audit events, and security events.

Frequently asked questions

Common questions about connecting Aha to AI agents with Metorial.

  1. How many tools does the Aha MCP server have?
    The Aha MCP server exposes 17 tools, including List Releases, List Ideas, Manage Feature. Each one is governed and traced through Metorial.
  2. Aha exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Aha MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Aha and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Aha MCP server yourself or use the hosted gateway.

Connect Aha to production AI agents

See how Metorial gives your team governed access to Aha, with tracing and security controls built in.

Book a demoDeploy Aha