# Hamn

> Hamn is an open-source MCP server for developer tools. Read-only-by-default MCP server for App Store Connect, TestFlight, reviews and reports. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Repository:** https://github.com/idoo/hamn
- **MCP Registry name:** io.github.idoo/hamn
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Hamn gives an assistant the same reach as the App Store Connect web interface, from release checklists and TestFlight to listings, screenshots, reviews, sales reports, in-app purchases, signing and Xcode Cloud. A raw API tool covers anything else.

Safety is the main design point. Write tools are not even listed until you switch writes on, and anything public or hard to undo shows a preview and waits for confirmation. The README also mentions a guard against prompt injection, so a review reading "ignore previous instructions" is treated as plain text. It claims no telemetry and talks only to Apple's endpoints.

Optional toolsets add post-release insights such as a rollout-pausing guard, a daily digest, an analytics funnel and keyword rank tracking, and a web toolset that creates apps and fills in App Privacy through your Apple ID. It is a Go binary under the MIT licence, installable by script or Homebrew, with signed releases, and it can configure Claude Code, Claude Desktop, Cursor, Codex, VS Code and Windsurf.

## Features

- **Release management:** Work with release checklists, metadata diffs and submissions.
- **TestFlight and reviews:** Manage beta builds and read or triage customer reviews.
- **Sales and analytics:** Pull sales reports and, with web login, App Analytics funnels.
- **Write protection:** Write tools stay hidden until enabled, and public changes wait for approval.
- **Toolsets:** Group tools on or off so the agent only sees what you use.
- **Verified releases:** Signed binaries with SBOMs and build attestations.
- **Container and bundle:** Also published as an MCPB bundle and an OCI image.

## Good for

- Check release readiness before submitting an app
- Summarise new reviews and ratings each morning
- Look up sales and download figures
- Pause a phased rollout when health drops

## Install

### Claude Code (Terminal)

```sh
claude mcp add hamn --env ASC_KEY_ID='<ASC_KEY_ID>' --env ASC_PRIVATE_KEY='<ASC_PRIVATE_KEY>' -- docker run -i --rm -e ASC_KEY_ID -e ASC_PRIVATE_KEY ghcr.io/idoo/hamn:0.1.3
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hamn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ASC_KEY_ID",
        "-e",
        "ASC_PRIVATE_KEY",
        "ghcr.io/idoo/hamn:0.1.3"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hamn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ASC_KEY_ID",
        "-e",
        "ASC_PRIVATE_KEY",
        "ghcr.io/idoo/hamn:0.1.3"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hamn": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ASC_KEY_ID",
        "-e",
        "ASC_PRIVATE_KEY",
        "ghcr.io/idoo/hamn:0.1.3"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hamn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ASC_KEY_ID",
        "-e",
        "ASC_PRIVATE_KEY",
        "ghcr.io/idoo/hamn:0.1.3"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hamn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ASC_KEY_ID",
        "-e",
        "ASC_PRIVATE_KEY",
        "ghcr.io/idoo/hamn:0.1.3"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>"
      }
    }
  }
}
```

## FAQ

### Can it change my app without asking?

By default no. It is read-only, and public or hard-to-undo actions show a preview and wait for your yes.

### What credentials does it need?

An App Store Connect API key (key ID, issuer ID and .p8 private key), read from a file, env var or the OS keychain.

### What licence is it under?

MIT.

### Does it send telemetry?

The README says no; it contacts Apple's API, Apple-issued upload URLs and the public iTunes Search API.

### Is Hamn free?

Yes. Hamn is open source, so you can use and self-host it for free.

### How do I add Hamn to Claude Code?

Run this command in your terminal: claude mcp add hamn --env ASC_KEY_ID='<ASC_KEY_ID>' --env ASC_PRIVATE_KEY='<ASC_PRIVATE_KEY>' -- docker run -i --rm -e ASC_KEY_ID -e ASC_PRIVATE_KEY ghcr.io/idoo/hamn:0.1.3

### What are the best alternatives to Hamn?

The closest alternatives to Hamn are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/hamn
