# ScreenPost

> ScreenPost is a paid MCP server for developer tools. Lets AI agents on your Mac capture, edit and post screenshots to X, with your approval. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** macOS, CLI, API
- **Website:** https://screenpost.app/mcp
- **Repository:** https://github.com/lamazzing/screenpost-mcp
- **MCP Registry name:** app.screenpost/screenpost
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

The README describes ScreenPost as a native macOS app for screenshots, screen recordings and posting to X, and this repository holds only the launchers that connect an MCP client to the helper bundled inside the app. Once agent access is switched on in the app's settings, a client such as Claude Code, Claude Desktop or Cursor can trigger captures, recordings, annotations, secret redaction and exports through the running app.

The server runs locally and talks to ScreenPost over a private socket in the user's folder. Actions that publish or leave the machine, including posts, scheduled posts, share links, uploads and deletions, pause for approval in a native sheet that shows the exact image, text and destination before anything is sent.

It suits Mac users who regularly turn screen captures into X posts or changelog visuals and want an agent to handle the capture-to-post steps. It requires an Apple Silicon Mac on macOS 14 or later and a paid ScreenPost licence after a 7-day trial, and the server code is proprietary rather than open source.

## Features

- **Screen capture and recording:** Takes window or display screenshots and starts, stops and cancels screen recordings.
- **Annotation and redaction:** Adds annotations and crops, and covers likely secrets such as API keys in a capture.
- **Export and GIF creation:** Exports captures, trims recordings and turns clips into GIFs.
- **X posting with approval:** Composes, schedules and posts to X, with each send requiring the user's approval in the app.
- **Expiring share links:** Creates, updates and revokes share links, which also need approval.
- **Local-only operation:** The helper talks to the running app on the Mac and does not send these tools' data to a ScreenPost server.

## Good for

- Capturing a UI change in an app and posting it to X with a short changelog
- Recording a short screen clip and converting it to a GIF under X's size limit
- Redacting API keys from a screenshot before exporting it
- Drafting and scheduling X posts with attached captures from an MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add screenpost -- npx -y https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "screenpost": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "screenpost": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "screenpost": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "screenpost": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "screenpost": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb"
      ]
    }
  }
}
```

## Tools

- `take_screenshot`: Capture a screenshot.
- `start_recording`: Start a screen recording.
- `stop_recording`: Stop a screen recording.
- `annotate`: Add annotations to a capture.
- `crop`: Crop a capture.
- `redact_secrets`: Cover likely secrets in a capture.
- `make_gif`: Create a GIF from a recording.
- `export`: Export a capture.
- `compose_post`: Compose an X post.
- `post_now`: Post to X, pending approval.
- `schedule_post`: Schedule an X post, pending approval.
- `create_share_link`: Create a share link, pending approval.

## FAQ

### Does the MCP server cost extra?

The site says no: the server is part of ScreenPost, free during the 7-day trial, then $29 once for every feature on 3 Macs.

### Is it open source?

No. The README says the ScreenPost app is proprietary and the server ships inside the signed app; the repository's MIT licence covers only its launcher files.

### Which platforms are supported?

The site says ScreenPost and its MCP server are macOS only, requiring Apple Silicon and macOS 14 or later. Windows and Linux are not supported.

### Can an agent post without my approval?

According to the site, posting, scheduling, share links, uploads and deletes return awaiting_approval and only the user can approve them in the app.

### Is ScreenPost free?

No. ScreenPost is a paid product.

### How do I add ScreenPost to Claude Code?

Run this command in your terminal: claude mcp add screenpost -- npx -y https://github.com/lamazzing/screenpost-mcp/releases/download/v1.0.1/screenpost.mcpb

### What are the best alternatives to ScreenPost?

The closest alternatives to ScreenPost are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/screenpost
