ScreenTapDocs
PricingSupportBack to site

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
Docs / Claude Code⌄

Getting started

  • How it works
  • Installation
  • First-time setup

Connect your agent

  • Overview
  • Claude Code
  • Claude Desktop
  • Cursor
  • Codex
  • Windsurf
  • VS Code
  • Gemini CLI
  • Other clients

Using ScreenTap

  • Giving tasks
  • Tools

Account

  • License & billing
  • Privacy

Help

  • Troubleshooting
← PreviousOverviewNext →Claude Desktop

Connect your agent

Set up Claude Code

One terminal command, works in every project.

  1. 1

    Open ScreenTap

    The MCP server runs while the ScreenTap app is open and your iPhone is set up.

  2. 2

    Add ScreenTap to Claude Code

    Run this once in your terminal. --scope user makes ScreenTap available in every project. Leave it out to add it to the current project only.

    Terminal
    claude mcp add --transport http --scope user screentap http://127.0.0.1:47811/mcp
  3. 3

    Check it's connected

    screentap should be listed as connected.

    Terminal
    claude mcp list
  4. 4

    Try it

    Start a new Claude Code session (existing sessions don't pick up new servers) and ask:

    Prompt
    Take a screenshot of my iPhone and tell me what's on screen.

Good to know

  • Inside a session, /mcp shows ScreenTap's status and its tools.
  • To remove it later: claude mcp remove screentap --scope user

Not working?

Check that the ScreenTap app is open and your iPhone is connected, then restart your agent or start a new session. More fixes in Troubleshooting.