# Buildtree

> Buildtree is a freemium MCP server for developer tools. Build, upload and share Android and iOS test builds with QR codes and tester feedback. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://buildtree.sh/docs/mcp
- **Repository:** https://github.com/engineerdeep/buildtree-mcp
- **MCP Registry name:** io.github.engineerdeep/buildtree
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

Buildtree distributes mobile test builds, and its local MCP server lets a coding agent do the whole chain. The agent logs in through a browser approval, creates a project, inspects the app folder to detect Expo, React Native, Flutter or native Android and iOS, writes buildtree.config.json, runs the build, uploads the .apk, .aab or .ipa and returns pinned, folder and release links with a QR code image. It can then read tester feedback, screenshots included.

Mobile builds take 5 to 30 minutes, so the server streams progress, but clients with a hard tool timeout may cut it off. The docs recommend raising the timeout to 1,800 seconds in Codex or letting the agent run the build in its own shell and only upload through the server. A separate remote server at buildtree.sh/api/mcp uses OAuth and only shares links, QR codes and feedback.

Plans are fixed monthly with hard storage limits and no overage billing. Free covers one project with 5 GB and 30-day retention, and paid tiers raise projects, storage, retention and team features. Prices are not listed. The package is MIT licensed and needs Node 20 or later.

## Features

- **Framework detection:** Recognizes Expo, React Native, Flutter and native apps and suggests build commands.
- **Build and upload:** Runs the build with progress updates and uploads the artifact.
- **Install links and QR:** Returns pinned, folder and release URLs plus a QR image.
- **Tester feedback:** Reads feedback and screenshots from install pages.
- **Remote server:** An OAuth-based HTTPS server for sharing links and reading feedback.
- **Resources and prompt:** Provides a workflow guide, framework recipes and a setup prompt.

## Good for

- Have an agent set up distribution for a new app
- Build an Android test build and get a QR code
- Read tester feedback and start fixing reported issues
- Share the latest iOS build link from ChatGPT or Claude

## Install

### Claude Code (Terminal)

```sh
claude mcp add buildtree --env BUILDTREE_TOKEN='<BUILDTREE_TOKEN>' -- npx -y @buildtree/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "buildtree": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<BUILDTREE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buildtree": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<BUILDTREE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "buildtree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<BUILDTREE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buildtree": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<BUILDTREE_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "buildtree": {
      "command": "npx",
      "args": [
        "-y",
        "@buildtree/mcp"
      ],
      "env": {
        "BUILDTREE_TOKEN": "<BUILDTREE_TOKEN>"
      }
    }
  }
}
```

## Tools

- `buildtree_whoami`: Show account, organization and plan.
- `buildtree_login`: Sign in through the browser.
- `buildtree_login_status`: Check login status.
- `buildtree_list_projects`: List projects.
- `buildtree_create_project`: Create a project.
- `buildtree_detect_project`: Detect framework and suggest build commands.
- `buildtree_write_config`: Write buildtree.config.json.
- `buildtree_build`: Run the configured build.
- `buildtree_upload`: Upload a build and return links and QR.
- `buildtree_list_builds`: List builds.
- `buildtree_get_install_links`: Get install links and QR for a build.
- `buildtree_list_feedback`: Read tester feedback.

## FAQ

### What file types can it upload?

Android .apk and .aab files and iOS .ipa files.

### Does it work without installing anything?

The remote server at buildtree.sh/api/mcp shares links and feedback with no install; building and uploading need the local server.

### Why do builds time out?

Mobile builds take 5 to 30 minutes, so some clients need a longer tool timeout or the agent can build in its own shell.

### Is there a free plan?

Yes: 1 project, 5 GB storage and 30-day retention.

### Is Buildtree free?

Buildtree has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add buildtree --env BUILDTREE_TOKEN='<BUILDTREE_TOKEN>' -- npx -y @buildtree/mcp

### What are the best alternatives to Buildtree?

The closest alternatives to Buildtree are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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