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 Desktop⌄

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
← PreviousClaude CodeNext →Cursor

Connect your agent

Set up Claude Desktop

Add one entry to the config file, then restart.

  1. 1

    Open the config file

    In Claude Desktop, open Settings › Developer › Edit Config. This opens claude_desktop_config.json in ~/Library/Application Support/Claude/.

  2. 2

    Add ScreenTap

    Paste this in. If the file already has an mcpServers section, add only the "screentap" entry inside it.

    claude_desktop_config.json
    {
      "mcpServers": {
        "screentap": {
          "command": "/Applications/ScreenTap.app/Contents/MacOS/ScreenTap",
          "args": ["--stdio"]
        }
      }
    }
  3. 3

    Restart Claude Desktop

    Quit it completely with ⌘Q (closing the window isn't enough), then open it again.

  4. 4

    Check it's connected

    Open the tools menu in a new chat. ScreenTap and its tools should be listed. Then try:

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

Good to know

  • Claude Desktop only starts local programs, so it talks to ScreenTap through the app's stdio mode. Keep the ScreenTap app open too.
  • If you keep ScreenTap somewhere other than Applications, change the path in "command" to match.

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.