Browse the user guide

Claude app (Claude Desktop)

Connect the Claude desktop app to Shotomatic over MCP with one click or a config entry, check that it works, and fix common problems.

Updated November 16, 2026

View Markdown
On this page

The Claude app for Mac and Windows can use Shotomatic through Shotomatic's local MCP server. Shotomatic lists it as Claude Desktop.

Connect with one click

  1. Open Shotomatic and go to Settings > AI agents (Command + ,, or Ctrl + , on Windows).
  2. Under Connect an agent, select Connect next to Claude.
  3. Quit and reopen the Claude app.

Shotomatic adds itself to claude_desktop_config.json, turns on Let AI agents use Shotomatic, and allows the Claude app, so no approval card appears. If Claude Code is installed too, the same Connect sets it up as well.

Add it by hand

Turn on Let AI agents use Shotomatic in Settings > AI agents and install Node 18.3 or later. In the Claude app, open Settings > Developer > Edit Config. This opens claude_desktop_config.json (on Windows the file is in %APPDATA%\Claude). Add:

{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}

If the file already has an mcpServers block, add the shotomatic entry inside it. Save, then quit and reopen the Claude app. The first time it connects, Shotomatic shows an approval card; select Allow.

Check that it works

Start a new chat and ask:

"Check Shotomatic's status and tell me what you can do with it."

A working setup answers with the Shotomatic version, whether Screen Recording and Accessibility are granted on a Mac, your plan and the free screenshots left today, whether the website browser is installed, and any capture already running.

If the tool is unavailable

  • Shotomatic does not appear in the chat's tools. Quit the Claude app completely and open it again. Closing the window is not enough.
  • The config change has no effect. Check that the JSON is valid and that shotomatic sits inside mcpServers.
  • "MCP access is turned off." Turn on Let AI agents use Shotomatic in Settings > AI agents, then restart the Claude app.
  • The agent waits for approval. Open Shotomatic and select Allow on the card.
  • npx is not found. This applies to the manual entry only. See the troubleshooting list for all clients.

In Settings > AI agents, the Claude app is listed under Approved agents as Claude Desktop, separate from Claude Code. Next, try a request from What agents can do.

Claude app (Claude Desktop) | User Guide | Shotomatic