buildtree MCP server
MCP server for buildtree, the fastest way to share Android and iOS builds with testers. Let your AI coding agent set up buildtree for your app, run the build, upload the .apk or .ipa, and hand you an install link and QR code to share. It can also read the feedback and screenshots testers send back.
Works with Expo, React Native, Flutter, and native Android and iOS apps, in Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor and Windsurf.
"Set up buildtree for this app and give me a QR code for an Android build."
Remote server and ChatGPT plugin
You do not need to install anything to share links and read feedback: buildtree runs this server's read-and-share half at https://buildtree.sh/api/mcp (OAuth 2.1).
Claude Code, remote server (sign in once through the browser):
claude mcp add --transport http --scope user buildtree https://buildtree.sh/api/mcp
Then run /mcp, pick buildtree, choose Authenticate, and approve in the browser.
Claude Code, the plugin (skills plus the local server, which can also build and upload). Inside Claude Code:
/plugin marketplace add engineerdeep/buildtree-mcp
/plugin install buildtree@buildtree
Codex: codex plugin marketplace add engineerdeep/buildtree-mcp, then install buildtree from the Plugins directory.
ChatGPT: Plugins, the plus button, Add custom MCP server, URL https://buildtree.sh/api/mcp.
Step-by-step with what to expect at each screen: https://buildtree.sh/docs/chatgpt. The local server below is for coding agents that also build and upload.
Install
Claude Code
claude mcp add --transport stdio buildtree -- npx -y @buildtree/mcp
Claude Desktop: download buildtree-mcp-<version>.mcpb from the latest release and double-click it. Or add the JSON below to claude_desktop_config.json.
Codex CLI (~/.codex/config.toml)
[mcp_servers.buildtree]
command = "npx"
args = ["-y", "@buildtree/mcp"]
tool_timeout_sec = 1800
Gemini CLI, Cursor, Windsurf, Claude Desktop (JSON)
{
"mcpServers": {
"buildtree": { "command": "npx", "args": ["-y", "@buildtree/mcp"] }
}
}
Requires Node 20 or later.
Tools
| Tool | What it does |
|---|---|
buildtree_whoami | Account, organization and plan |
buildtree_login, buildtree_login_status | Browser login, shared with the buildtree CLI |
buildtree_list_projects, buildtree_create_project | One project per app |
buildtree_detect_project | Detects Expo, React Native, Flutter or native and suggests build commands |
buildtree_write_config | Writes buildtree.config.json |
buildtree_build | Runs the build with progress updates |
buildtree_upload | Uploads the build; returns install links and a QR code image |
buildtree_list_builds, buildtree_get_install_links | Browse builds, get links and QR for any build |
buildtree_list_feedback | Tester feedback with screenshots |
Resources: buildtree://guide (the workflow) and buildtree://frameworks/{expo|react-native|flutter|android|ios} (build recipes). Prompt: setup.
Sign in
The first time, your agent opens a browser page where you approve the connection. The login is stored where the buildtree CLI keeps its own, so either can sign in for both. In CI, set BUILDTREE_TOKEN to an API token from the buildtree dashboard. Tokens never appear in tool output.
Links
- Docs: https://buildtree.sh/docs/mcp
- How to share a build with testers: https://buildtree.sh/docs/guides/share-app-with-testers
- CLI:
@buildtree/cli - Support: hello@buildtree.sh
MIT licensed.