Hamn
Read-only-by-default MCP server for App Store Connect, TestFlight, reviews and reports
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.1.3
- Listing updated
- today
Similar MCP servers
About Hamn
Hamn is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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.3Add to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ASC_KEY_IDApp Store Connect API key IDRequiredASC_ISSUER_IDIssuer ID (omit for an Individual API key)ASC_PRIVATE_KEYContents of the .p8 key (PEM or base64 PEM)RequiredASC_VENDOR_NUMBERVendor number for sales and finance reportsHAMN_ALLOW_WRITESSet to 1 to expose write and destructive tools
What it does
- 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
Pricing
Open source
MIT licensed, free
Hamn 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.


