Claude Code
Connect Claude Code to Shotomatic over MCP with one click or one command, check that it works, and fix common setup problems.
Updated November 16, 2026
Claude Code can use Shotomatic on your Mac or Windows PC through Shotomatic's local MCP server. Shotomatic is tested with Claude Code.
Connect with one click
- Open Shotomatic and go to Settings > AI agents (
Command + ,, orCtrl + ,on Windows). - Under Connect an agent, select Connect next to Claude.
Shotomatic runs claude mcp add for you with user scope, so Shotomatic is available in every project. It also turns on Let AI agents use Shotomatic and allows Claude Code, so no approval card appears. Start a new Claude Code session to load the server.
Claude appears in the list once Claude Code or the Claude app is installed. One Connect sets up whichever of the two is on your computer.
Add it by hand
If you prefer the command line, turn on Let AI agents use Shotomatic in Settings > AI agents, install Node 18.3 or later, and run:
claude mcp add --scope user shotomatic -- npx -y shotomatic mcp
Without --scope user, Claude Code adds the server to the current project only. The first time Claude Code connects this way, Shotomatic shows an approval card; select Allow. See Approvals and confirmations.
Check that it works
Run claude mcp list in a terminal, or enter /mcp in a session, and look for shotomatic. Then 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
shotomaticis missing from/mcp. Start a new session. If you added the server without--scope user, open Claude Code in the same project folder.- Connect shows an error about the claude command. Open Claude Code once in a terminal so its command is installed, then select Connect again.
- "MCP access is turned off." Turn on Let AI agents use Shotomatic in Settings > AI agents, then start a new session.
- The agent waits for approval. Open Shotomatic and select Allow on the card.
npxis not found. This applies to the manual command only. See the troubleshooting list for all clients.
Next, try a request from What agents can do, or see every tool in the Tools reference.