aha

This MCP server exposes 13 tools to access and search Aha! workspace data through the Model Context Protocol. It acts as a bridge between your AI assistant and Aha! data, allowing natural language requests to be translated into specific tool calls (e.g., get_feature, get_epic, search_documents) and returning structured JSON responses with the requested objects and HTTP status codes. Tools cover a range of Aha! objects including features, epics, releases,Goals, ideas, initiatives, key results, personas, releases, requirements, teams, users, workflows, and a search tool for documents. Configure your MCP client with the Aha! API token and domain, then issue tool calls like get_feature with a feature_id or search_documents with a query to retrieve data from your workspace.

To use, set up the environment variables as described in the configuration section, start the server (stdin or HTTP mode as needed), and instruct your AI assistant to call specific tools with the required parameters. For example, you can ask the assistant to search for documents related to a product roadmap, retrieve a specific epic by ID, or fetch details for a particular feature, release, or user. The server returns JSON including the requested object and the HTTP status, enabling seamless integration into downstream workflows and dashboards.

Prerequisites:

• Go 1.20+ installed on your machine
• An Aha! workspace with API access and a valid API token
• Access to run a Go-based MCP server or build from source

Install from source (recommended):

1. Ensure Go is installed and in PATH
2. Clone the repository: git clone https://github.com/grokify/aha-mcp-server.git
3. Navigate to the repository: cd aha-mcp-server
4. Build the server binary: go build ./cmd/aha-mcp-server
5. Run the server (stdio mode by default): ./aha-mcp-server

Alternative: install a pre-built binary (if available for your platform):

• Use go install to fetch and install the server: go install github.com/grokify/aha-mcp-server/cmd/aha-mcp-server@<version>
• Run the binary from your GOPATH/bin or module cache location.

Configuration steps after installation:

• Export required environment variables (AHA_API_TOKEN and AHA_DOMAIN) before starting the server: export AHA_API_TOKEN="your_api_token_here" export AHA_DOMAIN="your_aha_subdomain"
• Optionally run in HTTP mode for debugging: ./aha-mcp-server --http :8080

Verify installation by requesting a tool (e.g., using curl or your MCP client) once the server is running.

Tips and common issues:

• Ensure AHA_DOMAIN contains only your subdomain (e.g., mycompany), not mycompany.aha.io.
• The AHA_API_TOKEN must have proper permissions for the requested data.
• If you see missing environment variable errors, double-check that the container or shell session has AHA_API_TOKEN and AHA_DOMAIN set.
• To run in HTTP mode for easier testing with MCP clients, start with --http and connect to localhost:8080 by your client.
• If you encounter rate limits from Aha!, consider staggering requests or caching results where appropriate in your integration workflow.