Upload Android and iOS builds to share install links, QR codes, and collect tester feedback through an AI coding agent.
Also known as engineerdeep/buildtree-mcp, buildtree-mcp, @buildtree/mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- 236
- Latest version
- 0.1.2
- Last commit
- Oct 11, 2026
- License
- MIT
What is buildtree MCP?
buildtree uploads Android and iOS builds to share install links, QR codes, and collect tester feedback through an AI coding agent. It exposes 6 tools, such as buildtree_whoami, buildtree_detect_project, buildtree_write_config.
Summary generated from the project's README
About buildtree MCP server
Buildtree provides a way for developers to manage mobile application distribution through AI coding agents. It supports various frameworks including Expo, React Native, Flutter, and native Android or iOS development. Users can connect this server to clients like Claude Desktop, Cursor, Windsurf, Gemini CLI, and Claude Code to automate the entire deployment pipeline from local builds to tester feedback collection.
The server offers two distinct modes of operation. A remote server hosted at buildtree.sh/api/mcp allows for reading feedback and sharing links via OAuth 2.1, which works with ChatGPT and Claude Code. For developers needing to build and upload files, a local installation via npx is required. This local setup enables tools like buildtree_build and buildtree_upload to handle .apk and .ipa files directly.
Integration requires Node 20 or later. Authentication is handled through a browser-based login that syncs with the buildtree CLI, or via a BUILDTREE_TOKEN for continuous integration environments. The system manages projects, generates QR codes, and retrieves tester screenshots.
What you can do with it
- 1Automate mobile build deploymentAsk your AI agent to detect your project type, run the build, and upload the resulting file.
- 2Generate tester distribution assetsRequest a QR code or installation link for a specific Android or iOS build.
- 3Monitor tester feedbackHave your coding agent retrieve comments and screenshots sent by app testers.
Written from the project's README. Every use case is checked against a quote from it.
How to install buildtree MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall buildtree MCP in Claude Code
$ claude mcp add --env 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' buildtree-mcp -- npx -y @buildtree/mcpInstall buildtree MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"buildtree-mcp": {
"command": "npx",
"args": [
"-y",
"@buildtree/mcp"
],
"env": {
"BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
}
}
}
}Install buildtree MCP in VS Code
.vscode/mcp.json
{
"servers": {
"buildtree-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@buildtree/mcp"
],
"env": {
"BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
}
}
}
}Install buildtree MCP in VS Code CLI
$ code --add-mcp '{"name":"buildtree-mcp","type":"stdio","command":"npx","args":["-y","@buildtree/mcp"],"env":{"BUILDTREE_TOKEN":"<YOUR_BUILDTREE_TOKEN>"}}'Install buildtree MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"buildtree-mcp": {
"command": "npx",
"args": [
"-y",
"@buildtree/mcp"
],
"env": {
"BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
}
}
}
}Install buildtree MCP in Codex
$ codex mcp add buildtree-mcp --env 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' -- npx -y @buildtree/mcpInstall buildtree MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.buildtree-mcp] command = "npx" args = ["-y", "@buildtree/mcp"] [mcp_servers.buildtree-mcp.env] BUILDTREE_TOKEN = "<YOUR_BUILDTREE_TOKEN>"
Install buildtree MCP in Gemini CLI
$ gemini mcp add -s user -e 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' buildtree-mcp npx -- -y @buildtree/mcpInstall buildtree MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"buildtree-mcp": {
"command": "npx",
"args": [
"-y",
"@buildtree/mcp"
],
"env": {
"BUILDTREE_TOKEN": "<YOUR_BUILDTREE_TOKEN>"
}
}
}
}buildtree MCP tools 6
Detected from the READMEbuildtree_whoamibuildtree_detect_projectbuildtree_write_configbuildtree_buildbuildtree_uploadbuildtree_list_feedback
| buildtree_whoami | — | |
| buildtree_detect_project | — | |
| buildtree_write_config | — | |
| buildtree_build | — | |
| buildtree_upload | — | |
| buildtree_list_feedback | — |
Configuration
BUILDTREE_TOKENSecretAPI token from the buildtree dashboard (optional; the buildtree_login tool signs in interactively otherwise).
BUILDTREE_API_URLAPI origin. Defaults to https://buildtree.sh.
| Name | Description | |
|---|---|---|
| BUILDTREE_TOKEN | API token from the buildtree dashboard (optional; the buildtree_login tool signs in interactively otherwise). | Secret |
| BUILDTREE_API_URL | API origin. Defaults to https://buildtree.sh. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubbuildtree 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.
buildtree MCP questions
How do I add buildtree MCP to Claude Code?
Run claude mcp add --env 'BUILDTREE_TOKEN=<YOUR_BUILDTREE_TOKEN>' buildtree-mcp -- npx -y @buildtree/mcp in your terminal. Add --scope user to make it available in every project.
How do I add buildtree MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does buildtree MCP provide?
It exposes 6 tools, including buildtree_whoami, buildtree_detect_project, buildtree_write_config, buildtree_build, buildtree_upload.
What platforms does buildtree support?
It works with Expo, React Native, Flutter, and native Android and iOS applications.
How can I use buildtree in CI?
In CI environments, you can set the BUILDTREE_TOKEN environment variable to an API token from your buildtree dashboard.
Can the AI agent see tester feedback?
Yes, the server allows the agent to read tester feedback including screenshots.