screenpost
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ScreenPost MCP
Connect an MCP client to ScreenPost, a native macOS app for screenshots, screen recordings and posting to X. The MCP server is a stdio helper that ships inside the app. This repository contains only the launchers and listing files that point your client at it: an MCPB bundle, a Claude Code plugin, and registry metadata.
The ScreenPost app itself is proprietary. The MIT license in this repository covers only the files in this repository.
Full documentation: https://screenpost.app/mcp
Requirements
A Mac with Apple Silicon, macOS 14 or later.
ScreenPost installed in /Applications. It is a paid app ($29 once) with a free 7-day trial: https://screenpost.app
In ScreenPost, turn on Settings > Agents > "Allow agents to control ScreenPost". Until then the helper has nothing to talk to.
The helper path is /Applications/ScreenPost.app/Contents/Helpers/screenpost-mcp. It speaks newline-delimited JSON-RPC over stdio and takes no arguments or environment variables. The server name is screenpost.
Related MCP server: Screen Vision MCP Server
Install
Claude Desktop
Download screenpost.mcpb from the latest release and open it. The bundle is a small Node launcher that starts the helper inside the installed app.
Claude Code
Plugin:
/plugin marketplace add lamazzing/screenpost-mcp
/plugin install screenpost@screenpostOr one line, without the plugin:
claude mcp add screenpost -- /Applications/ScreenPost.app/Contents/Helpers/screenpost-mcpCursor
Or add to ~/.cursor/mcp.json, using the JSON under "Generic" below.
VS Code
Add to .vscode/mcp.json (VS Code uses the servers key):
{
"servers": {
"screenpost": {
"type": "stdio",
"command": "/Applications/ScreenPost.app/Contents/Helpers/screenpost-mcp"
}
}
}Generic JSON
{
"mcpServers": {
"screenpost": {
"command": "/Applications/ScreenPost.app/Contents/Helpers/screenpost-mcp"
}
}
}Safety model
Agent access is off by default and is switched on by you in ScreenPost > Settings > Agents.
Everything runs on your Mac. The helper forwards to the running app over local IPC.
Posting and scheduling to X, share links, uploads and deletes wait for your approval in a native sheet in the app, showing the exact image, text and destination. No tool can approve its own request.
redact_secretsfinds and covers likely secrets in a capture before you export or share it.Share links are capability URLs that you can update or revoke (
update_share_link,revoke_share_link).
Tools (49)
Status and settings:
get_status,list_capabilities,get_settings,set_settings,get_editor_options,list_displays,list_windowsCapture and record:
take_screenshot,start_recording,stop_recording,cancel_recording,get_recording_status,import_mediaLibrary:
list_captures,get_capture,get_media_base64,delete_capture,reveal_in_finder,open_in_editor,copy_to_clipboardEdit:
annotate,crop,beautify,list_beautify_presets,redact_secrets,extract_text,trim_clip,make_gif,undo,redo,revert_editsExport:
export,upload_media_to_urlPosting to X:
compose_post,enhance_text,count_post_length,post_now,schedule_post,list_posts,list_scheduled,cancel_scheduled,retry_failed,get_request_status,set_default_x_account,open_in_x_composeShare links:
create_share_link,update_share_link,revoke_share_link,share_link_stats
If the helper is missing
The launcher prints this to stderr and answers requests with a JSON-RPC error: "Install ScreenPost from https://screenpost.app and turn on Settings > Agents."
Development
npm test runs the launcher tests. They call only initialize, tools/list and the read-only tools get_status and list_capabilities, and never post or call external services. npm run pack builds screenpost.mcpb with the official MCPB CLI.
Support
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Screenshot, PDF, OG-image, and page extraction (markdown/JSON) over MCP. Bearer key or x402.
Clean PNG/JPEG screenshots via REST or MCP, with goal-driven multi-step navigation.
Capture website screenshots, run bulk captures, and manage screenshot schedules and history.
Create App Store screenshots, icons, ASO copy, localization, and revisions via hosted MCP.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables LLMs to capture screenshots and screen recordings through MCP with chunked session-based transfers for reliable image consumption. Supports multi-monitor selection, timeline capture, and compatibility with both vision and non-vision language models.111-
- AlicenseAqualityDmaintenanceEnables screen capture, OCR text extraction, and automated clicking on macOS through MCP. Supports fullscreen, window, and region capture with optional text recognition and monitoring.9MIT
- AlicenseNot gradedqualityDmaintenanceEnables MCP clients to control macOS via accessibility and screen recording, providing tools to list apps, observe UI, click, type, press keys, and scroll.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP hosts to observe and operate macOS apps by reading accessible controls, entering text, clicking, scrolling, capturing screenshots, and performing on-device OCR, with background app control and explicit human authorization.4MIT