Setup Guide

Getting Started with
Cursor</>Mobile

Control your Cursor IDE from anywhere using your phone. This guide will walk you through every step to get set up.

Before You Begin

Make sure you have the following:

  • Cursor IDE installed

    Download from cursor.com/download if you haven't already

  • A Cursor</>Mobile account

    You should already have one if you're viewing this page while logged in

  • An iPhone or Android phone

    iOS 15+ or Android 10+ recommended

  • Internet connection on both devices

    Your computer and phone need to be online (they don't need to be on the same network)

Step 1: Install the Claude Extension in Cursor

1

Set Up Claude AI in Cursor

Cursor</>Mobile works by letting you interact with Claude AI from your phone. First, you need to have the Claude extension installed and configured in Cursor.

Installing the Claude Extension

  1. 1.Open Cursor IDE on your computer
  2. 2.Click on the Extensions icon in the left sidebar (or press Cmd+Shift+X on Mac / Ctrl+Shift+X on Windows)
  3. 3.Search for "Claude" in the extensions marketplace
  4. 4.Find the official "Claude" extension by Anthropic and click Install

Logging In to Claude

  1. 1.After installing, you'll see a Claude icon appear in the left sidebar
  2. 2.Click the Claude icon to open the Claude panel
  3. 3.Click "Sign In" to authenticate with your Anthropic account
  4. Don't have an account? Sign up for Claude here
  5. 4.Follow the browser prompts to complete the login process
  6. 5.Once logged in, you should see the Claude chat interface in Cursor
Already have Claude set up? If you've already installed and logged into the Claude extension, you can skip to Step 2.

Step 2: Install the Cursor</>Mobile Extension

2

Download and Install the Extension

The Cursor</>Mobile Bridge extension connects your Cursor IDE to your mobile device. Here's how to install it:

AInstall from VSIX file (Recommended)

  1. 1.Download the extension file by clicking the button below
  2. 2.Open Cursor IDE on your computer
  3. 3.
    Open the Command Palette:
    • • Mac: Press Cmd + Shift + P
    • • Windows/Linux: Press Ctrl + Shift + P
  4. 4.Type Install from VSIX and select "Extensions: Install from VSIX..."
  5. 5.Navigate to your Downloads folder and select the cursor-mobile-bridge.vsix file
  6. 6.Click "Install" and wait for the installation to complete
  7. 7.Restart Cursor when prompted (or manually restart it)

BVerify the Extension is Installed

  1. 1.Open the Extensions panel in Cursor (click the puzzle piece icon in the left sidebar, or press Cmd/Ctrl + Shift + X)
  2. 2.Search for "Cursor Mobile" in the installed extensions
  3. 3.You should see "Cursor Mobile Bridge" listed and enabled
Having trouble? Make sure you've completely restarted Cursor after installing the extension. Sometimes a full quit (Cmd+Q on Mac, Alt+F4 on Windows) is needed rather than just closing the window.

Step 3: Download the Mobile App

3

Get the App on Your Phone

Download the Cursor</>Mobile app from your device's app store.

iPhone / iPad

iOS 15.0 or later

  1. 1.Open the App Store on your iPhone or iPad
  2. 2.Search for "Cursor Mobile"
  3. 3.Tap "Get" to download and install

Android

Android 10 or later

  1. 1.Open the Google Play Store
  2. 2.Search for "Cursor Mobile"
  3. 3.Tap "Install" to download

After Installing the App

  1. 1.Open the Cursor Mobile app
  2. 2.Tap "Sign In" and log in with the same account you use on this website
  3. 3.When prompted, allow push notifications - this lets you get notified when Claude completes tasks
  4. 4.You'll see a screen asking you to pair with your desktop - keep the app open for the next step
Important: Make sure to enable push notifications when the app asks. Without notifications, you won't be alerted when Claude finishes a task while the app is in the background.

Step 4: Connect Your Devices

4

Log In to Connect

Your devices connect automatically when you log in with the same account. No pairing codes needed!

On Your Computer (in Cursor IDE)

  1. 1.
    Open the Command Palette:
    • • Mac: Cmd + Shift + P
    • • Windows/Linux: Ctrl + Shift + P
  2. 2.Type Cursor Mobile and select "Cursor Mobile: Connect"
  3. 3.Log in with your Cursor</>Mobile account (the same account you created on this website)
  4. 4.Once logged in, the extension will automatically connect to the server

On Your Phone (in the Cursor</>Mobile App)

  1. 1.Open the Cursor</>Mobile app
  2. 2.Log in with the same account you used on this website and in the extension
  3. 3.The app will automatically connect to your Cursor session
  4. 4.You should see a "Connected" status once both devices are online
That's It!

As long as both devices are logged into the same account, they'll automatically find each other and connect. Your devices will appear in the Dashboard.

Not connecting? Make sure both devices are logged into the same Cursor</>Mobile account and that Cursor is running on your computer.

Step 5: Start Using Cursor</>Mobile

5

You're All Set!

Your devices are now connected. Here's how to use Cursor</>Mobile.

Sending Messages to Claude

  1. 1.In the mobile app, you'll see a chat interface
  2. 2.Type your message or coding request in the text field at the bottom
  3. 3.Tap the send button
  4. 4.Your message will be sent to Claude in your Cursor IDE session
  5. 5.Watch as Claude's response streams back to your phone in real-time

Quick Actions

When Claude asks for confirmation (like running a command or making changes), you can quickly respond:

/yes

Approve the pending action

/no

Decline the pending action

Checking Conversation History

Want to see what was happening in your Claude session? Type:

history

This fetches the last 10 messages from your desktop Claude Code conversation, so you can catch up on what you were working on.

Setup Complete!

You can now send messages to Claude, approve actions, and control your coding session from anywhere. Your computer just needs to stay on with Cursor running.

Chat Commands

When using the Cursor</>Mobile app, you can send special commands from the chat interface. These commands are handled locally and give you quick access to useful features.

history

Fetches the last messages from your current Claude Code conversation and displays them in the mobile chat. Useful for catching up on what Claude was working on before you connected.

Example:Type history → Shows your recent conversation with Claude
testflightDeveloper

Builds and uploads a new version of the mobile app to TestFlight for testing. This command is primarily for developers managing the app.

testflightPatch version (1.0.0 → 1.0.1)
testflight --minorMinor version (1.0.0 → 1.1.0)
testflight --majorMajor version (1.0.0 → 2.0.0)
This command runs the build process on your Mac (where Cursor is running) and can take 5-10 minutes. You'll see real-time status updates in the chat.
Regular Messages

Any text that isn't a special command gets sent directly to Claude Code as a prompt. Just type naturally and Claude will respond.

> Add a dark mode toggle to the settings screen

Claude: I'll help you add a dark mode toggle...

Tips

  • •Commands are not case-sensitive — history, HISTORY, and History all work
  • •You must be connected to a Cursor device to use commands
  • •Long-running commands show real-time progress in the chat

What You Can Do

Chat with Claude

Send messages and prompts to Claude from your phone. Ask questions, request code changes, or start new tasks - all from the couch, a coffee shop, or anywhere else.

Run Terminal Commands

Execute terminal commands remotely through Claude. Start builds, run tests, deploy code, or manage git operations without being at your desk.

Real-time Sync

See Claude's responses stream to your phone in real-time as they're generated. It's just like being at your computer, but portable.

Push Notifications

Get notified when Claude completes a task or needs your attention. Close the app and go about your day - you'll be alerted when something needs you.

Troubleshooting

Frequently Asked Questions

Still Need Help?

Can't find what you're looking for? We're here to help.