
Bitrise MCP Server
Manage Bitrise apps, builds, artifacts, pipelines and releases from your AI assistant.
Add to your client
Copy the config for your MCP client and paste it into its config file.
claude mcp add --transport http bitrise https://mcp.bitrise.ioPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"bitrise-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.bitrise.io"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- A Bitrise account
- An MCP client that supports Streamable HTTP (and MCP OAuth for the recommended remote setup), e.g. Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI, or AWS Kiro
- For the local stdio server: Go (>=1.25) installed and a Bitrise Personal Access Token (BITRISE_TOKEN)
About Bitrise MCP Server
Official MCP server from Bitrise that wraps the Bitrise API so AI assistants can manage mobile CI/CD: list and register apps, trigger and inspect builds, read build logs and steps, manage artifacts and caches, control pipelines, administer workspaces/groups/members, run release management (connected apps, installable artifacts, tester groups), and operate CodePush deployments and updates. Offered as a hosted remote (Streamable HTTP + OAuth) server at https://mcp.bitrise.io, with a Go-based local stdio server as an alternative.
Tools & capabilities (81)
list_appsList all the apps available for the authenticated account.
register_appAdd a new app to Bitrise.
finish_bitrise_appFinish the setup of a Bitrise app.
get_appGet the details of a specific app.
delete_appDelete an app from Bitrise.
update_appUpdate an app.
get_bitrise_ymlGet the current Bitrise YML config file of a specified app.
update_bitrise_ymlUpdate the Bitrise YML config file of a specified app.
list_branchesList the branches with existing builds of an app's repository.
register_ssh_keyAdd an SSH key to a specific app.
register_webhookRegister an incoming webhook for a specific application.
list_buildsList all the builds of a specified app or all accessible builds.
trigger_bitrise_buildTrigger a new build/pipeline for a specified app.
get_buildGet a specific build of a given app.
abort_buildAbort a specific build.
get_build_logGet the build log of a specified build of an app.
get_build_bitrise_ymlGet the bitrise.yml of a build.
list_build_workflowsList the workflows of an app.
get_build_stepsGet step statuses of a specific build of a given app.
list_artifactsGet a list of all build artifacts.
get_artifactGet a specific build artifact.
delete_artifactDelete a build artifact.
update_artifactUpdate a build artifact (e.g. enable public page).
list_outgoing_webhooksList the outgoing webhooks of an app.
delete_outgoing_webhookDelete the outgoing webhook of an app.
update_outgoing_webhookUpdate an outgoing webhook for an app.
create_outgoing_webhookCreate an outgoing webhook for an app.
list_cache_itemsList the key-value cache items belonging to an app.
delete_all_cache_itemsDelete all key-value cache items belonging to an app.
delete_cache_itemDelete a key-value cache item.
get_cache_item_download_urlGet the download URL of a key-value cache item.
list_pipelinesList all pipelines and standalone builds of an app.
get_pipelineGet a pipeline of a given app.
abort_pipelineAbort a pipeline.
rebuild_pipelineRebuild a pipeline.
list_group_rolesList group roles for an app.
replace_group_rolesReplace group roles for an app.
list_workspacesList the workspaces the user has access to.
get_workspaceGet details for one workspace.
get_workspace_groupsGet the groups in a workspace.
create_workspace_groupCreate a group in a workspace.
get_workspace_membersGet the members in a workspace.
invite_member_to_workspaceInvite a member to a workspace.
add_member_to_groupAdd a member to a group.
meGet info from the currently authenticated user account.
create_connected_appAdd a new Release Management connected app to Bitrise.
list_connected_appsList Release Management connected apps for the account within a workspace.
get_connected_appGet a Release Management connected app for the authenticated account.
update_connected_appUpdate a connected app.
list_installable_artifactsList Release Management installable artifacts of a connected app.
generate_installable_artifact_upload_urlGenerate a signed upload URL for an installable artifact.
get_installable_artifact_upload_and_processing_statusGet the processing and upload status of an installable artifact.
set_installable_artifact_public_install_pageToggle the public install page for an installable artifact.
list_build_distribution_versionsList Build Distribution versions available for testers.
list_build_distribution_version_test_buildsList test builds for a given build distribution version.
create_tester_groupCreate a tester group for a Release Management connected app.
notify_tester_groupNotify a tester group about a new test build.
add_testers_to_tester_groupAdd testers to a tester group of a connected app.
update_tester_groupUpdate the given tester group settings.
list_tester_groupsList tester groups related to a specific connected app.
get_tester_groupGet the details of the selected tester group.
get_potential_testersList potential testers who can be added to a tester group.
get_testersList testers associated with a tester group of a connected app.
validate_bitrise_ymlValidate a Bitrise YML config file.
step_searchFind steps for building workflows or step bundles by name, description, tags or maintainers.
step_inputsList inputs of a step with their defaults and allowed values.
list_available_stacksList available stacks with machine configurations and version info.
codepush_list_deploymentsList CodePush deployments for a Bitrise app.
codepush_get_deploymentGet a specific CodePush deployment by its ID.
codepush_create_deploymentCreate a new CodePush deployment for a Bitrise app.
codepush_update_deploymentUpdate the name of an existing CodePush deployment.
codepush_delete_deploymentDelete a CodePush deployment (irreversible).
codepush_promote_deploymentPromote a package from a source deployment to a target deployment.
codepush_rollback_deploymentRollback a CodePush deployment to its previous version.
codepush_list_updatesList CodePush updates for a specific deployment.
codepush_get_updateGet a specific CodePush update by its ID.
codepush_patch_updatePatch a CodePush update's disabled state, mandatory flag, or rollout percentage.
codepush_delete_updateDelete a CodePush update (irreversible).
codepush_get_update_statusGet the processing status of a CodePush update.
codepush_generate_update_upload_urlGenerate a signed upload URL for a CodePush update bundle.
codepush_get_metricsGet workspace-level CodePush usage metrics and limits.
What this server can do
Bitrise MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Investigate why a recent iOS or Android build failed by reading its logs and step statuses
- Trigger builds or pipelines on a branch and monitor their status from chat
- Report build success rates and CI health across branches and workflows
- Administer workspaces: invite members, create groups, and manage roles
- Run mobile release management: manage connected apps, installable artifacts, and tester groups
- Operate CodePush over-the-air updates: create deployments, promote, roll back, and track metrics
Security notes
The recommended remote server uses OAuth — you sign in to your Bitrise account in the browser and approve a consent screen on first tool use; no token to store. For PAT-based fallback, create a Bitrise API token under Account Settings -> Security and pass it as an Authorization: Bearer header; avoid hardcoding it (store it in a gitignored .env and reference it). The local stdio server requires a BITRISE_TOKEN environment variable. Tools include destructive operations (delete app, delete artifacts, abort builds, replace group roles, irreversible CodePush deletes), so review tool calls before approving.
Bitrise MCP Server FAQ
How do I authenticate?
The recommended remote server at https://mcp.bitrise.io uses OAuth: on first tool use your client opens a browser to sign in to Bitrise and approve a consent screen — no token to copy. For clients without MCP OAuth, you can pass a Bitrise Personal Access Token as an Authorization: Bearer header instead. The local stdio server uses a BITRISE_TOKEN environment variable.
Do I need to run anything locally?
No. The recommended setup is the hosted remote server over Streamable HTTP, so there is nothing to install. A local stdio server is available as an alternative and requires Go (>=1.25) plus a Bitrise PAT (run via `go run github.com/bitrise-io/bitrise-mcp/v2@v2`).
Which clients are supported?
Installation guides are provided for Claude Desktop and Claude Code, Cursor, VS Code, GitHub Copilot in JetBrains/Visual Studio/Eclipse/Xcode, Windsurf, Gemini CLI, and AWS Kiro.
Can I limit which tools are exposed?
Yes. Tools are grouped by API group. Pass a comma-separated list of groups via the ENABLED_API_GROUPS environment variable for the local stdio server, or the x-bitrise-enabled-api-groups HTTP header for the remote server, to reduce the number of tools (useful for token usage or client tool limits). All groups are enabled by default.
Alternatives to Bitrise MCP Server
Compare all alternatives →GitHub's official server for repos, issues, PRs, and Actions — local Docker or hosted remote.
Official AWS Labs server that lets agents call any AWS API via the AWS CLI surface.
Bulk Kubernetes port forwarding with an MCP server that lets AI assistants forward services, inspect pods, and monitor traffic.
Compare Bitrise MCP Server with: