Skip to main content
Cursor logo

Ship your mobile app from Cursor with Capgo

Cursor builds, publishes, and live-updates your Capacitor app: iOS and Android builds without a Mac, OTA fixes in minutes, one-click rollback.

  • IDE
  • Hosted MCP
  • Local MCP
  • Skills
  • CLI

Set up Capgo in Cursor

Three steps or less. Copy each block as is.

  1. Step 1

    Add the hosted Capgo MCP

    Add this to ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one. Cursor shows Needs login next to the server: click it to sign in. No API key needed.

    ~/.cursor/mcp.json 
    {
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp"
    }
  }
}

  2. Step 2

    Add the local CLI MCP for builds and uploads

    Run npx @capgo/cli@latest login once in the terminal, then add the capgo-cli entry next to capgo.

    ~/.cursor/mcp.json 
    {
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp"
    },
    "capgo-cli": {
      "command": "npx",
      "args": [
        "@capgo/cli@latest",
        "mcp"
      ]
    }
  }
}

  3. Step 3

    Install the Capgo skills

    Cursor reads skills from .agents/skills and .cursor/skills.

    Terminal
    $ npx skills add Cap-go/capgo-skills

What you can ask Cursor

Copy a prompt and paste it into Cursor. Replace the app ID and versions with yours.

  • Build

    “Build a signed iOS release of this app with Capgo Build.”

  • Publish

    “Request an Android release build and send it to the Google Play internal track.”

  • Update

    “Check if this change needs a native build or can ship as a live update.”

  • Update

    “Build the web app and push this fix to the production channel.”

  • Rollback

    “Roll back the last bundle on the production channel.”

  • Observe

    “Show update stats for v2.3.0: how many devices have it and how many failed.”

  • Observe

    “Why did my last iOS build fail? Read the build logs and suggest a fix.”

  • Build

    “Run Capgo doctor on this project and fix what it reports before we build.”

The full release loop

One account covers every step, from the first build to the next live fix.

  1. 1

    Build

    Signed iOS and Android builds in the cloud. No Mac and no Xcode on your side.

    Capgo Build for native apps
  2. 2

    Publish

    Send builds to TestFlight and Google Play, or submit them for store review.

    Build and publish iOS apps without a Mac
  3. 3

    Update

    Push JavaScript, HTML, and CSS fixes to a channel in minutes. Roll back in one step.

    Capgo live updates
  4. 4

    Observe

    See who got the update, what failed, and how each release performs.

    Capgo Observe

Cursor notes and limits

  • The Cursor agent runs terminal commands, so it can also call the Capgo CLI directly.
  • Cursor Cloud Agents do not get skills that only live on your machine. Commit .agents/skills to the repo to share them.
  • Turn off tools you do not need in Cursor settings to keep the tool list short.

FAQ

Capgo and Cursor: common questions

Can Cursor build my iOS app without a Mac?

Yes. Cursor runs the Capgo CLI, which uploads your project to Capgo Build. Capgo signs and builds the iOS and Android apps in the cloud and can send them to TestFlight and Google Play.

Native build docs

Do I need a Capgo API key for Cursor?

No API key needed for the hosted MCP: it signs in with OAuth. The local CLI MCP and the CLI use an API key that you save once with npx @capgo/cli@latest login. Create the key in the Capgo console under Settings, Organization, API keys.

Create a Capgo API key

Can Cursor roll back a bad update?

Yes. Ask Cursor to point the channel back to the previous bundle. Devices switch on their next update check. The Capgo updater also rolls back on its own when a new bundle fails to start.

Live update docs

Are live updates allowed on the App Store and Google Play?

Yes, for the web layer: JavaScript, HTML, CSS, and assets. Native code, new permissions, and new plugins still need a store release, which Capgo Build can make for you.

What does it cost to use Capgo from Cursor?

The MCP servers, skills, and CLI are free to use. You need a Capgo plan, and every plan starts with a 14-day free trial with no credit card. Builds, live updates, and Observe are in every plan.

Pricing

Ship your next release from Cursor

Create a Capgo account, connect Cursor, and push your first build or live update today.

Docs

Related pages