ScreenVerb MCP server

Let AI assistants search, read and organize the screenshots in your ScreenVerb cloud library. The server uses the Model Context Protocol (MCP), so it works with Claude, ChatGPT, Claude Code, Gemini CLI and other MCP clients.

Before you start

A ScreenVerb account with a Pro, Universal Pro or Max plan. See pricing.
Screenshots saved to your cloud library from the Mac or iOS app. The MCP server only reads your cloud library, not files on your device.
An MCP client that supports remote servers with OAuth.

Server URL:

https://mcp.screenverb.com/mcp

Connect your assistant

If ScreenVerb is listed in your assistant's connector or app directory, connect it from there. Otherwise, add it as a custom server using the steps below.

Claude

Open Customize → Connectors and search for ScreenVerb, or choose Add custom connector.
For a custom connector, paste the server URL.
Choose Connect, sign in to ScreenVerb and approve access.

ChatGPT

Open Settings → Apps and search for ScreenVerb. To add it manually, turn on developer mode under Advanced and create an app with the server URL and OAuth authentication.
Choose Connect, sign in to ScreenVerb and approve access.

Some ChatGPT plans only allow read tools in custom apps. Renaming and removing screenshots may need a Business, Enterprise or Edu workspace.

Claude Code

claude mcp add --transport http screenverb https://mcp.screenverb.com/mcp

Then run /mcp in Claude Code and choose ScreenVerb to sign in.

Gemini CLI

gemini mcp add --transport http screenverb https://mcp.screenverb.com/mcp

Then run /mcp auth screenverb to sign in.

Other MCP clients

Add a remote server using Streamable HTTP and the server URL. Clients that use a JSON config usually look like this:

{
  "mcpServers": {
    "screenverb": {
      "type": "http",
      "url": "https://mcp.screenverb.com/mcp"
    }
  }
}

The server supports OAuth discovery and dynamic client registration, so you don't need an API key.

Sign-in and permissions

When you connect, ScreenVerb asks you to sign in with Google or your email and password, then shows which access the assistant gets:

Read access lets the assistant list, search and view your screenshots, including recognized text and captions.
Update access lets the assistant rename screenshots and remove them from your library.

You can turn off either permission before approving. The assistant only sees the tools for the access you granted.

Available tools

Tool	Access	What it does
`list_screenshots`	Read	Lists screenshots in your cloud library, newest first by default. Supports paging and sorting by date, size or name.
`search_screenshots`	Read	Finds screenshots by filename, text recognized in the image, caption, tag or label, optionally limited to the last day, 7 days or 30 days.
`get_screenshot`	Read	Shows one screenshot to your assistant as an image, with its details and a private image link that expires within 2 hours.
`rename_screenshot`	Update	Changes a screenshot's filename. Its share link stays the same.
`delete_screenshot`	Update	Removes a screenshot from your cloud library. Assistants are told to ask you before using it.

Example prompts

Find the screenshot of the Stripe invoice I took last week.
List my 10 most recent screenshots and summarize what each one shows.
Search my screenshots for the error message about the expired token.
Rename my latest screenshot to “Q3 roadmap draft”.

Manage or disconnect

See every connected assistant on the MCP page in your dashboard, and disconnect any of them at any time. Disconnecting revokes its access right away. You can also remove ScreenVerb from your assistant's connector settings.

Data and privacy

The server only accesses screenshots in the signed-in account's cloud library, limited to the permissions you approved.
Screenshot details, recognized text, captions and, when your assistant opens a screenshot, a resized copy of the image are sent to your assistant when it calls a tool. Your assistant's provider handles that data under its own privacy policy.
Image links returned to the assistant are private and expire within 2 hours.
ScreenVerb does not read your conversations with the assistant. We keep connection records, such as the client name and when it connected, so you can review and revoke access.

Read the full Privacy Policy and Terms of Service.

Troubleshooting

“This account does not have access”

The signed-in account doesn't have a plan that includes MCP. Use "Use another account" on the sign-in page, or check your plan in the dashboard.

The assistant can't find a screenshot

Make sure the screenshot was saved to your cloud library. If your plan includes screenshot analysis, recognized text and captions can take a moment to appear after upload.

Rename or remove is missing

Reconnect and leave update access turned on, or check whether your assistant's plan allows write tools.

Support

Questions or problems? Email support@screenverb.com and the team will help.