## What it is ### Built into the app The server is a small helper inside Clacky.app (`Contents/MacOS/clacky-mcp`). No Node, no extra install. ### Off until you turn it on In Clacky, open **Settings → Connect AI tools (MCP)**. Each group of tools has its own switch. ### Your Mac does the work The helper hands each call to the running Clacky app, which asks you where it should and does the job. ## Connect your AI app Two minutes, once. Clacky shows the same snippets in Settings, with the path to your copy of the app. Claude Desktop → Settings → Developer → Edit Config, then add this to `claude_desktop_config.json`: `{ "mcpServers": { "clacky": { "command": "/Applications/Clacky.app/Contents/MacOS/clacky-mcp" } } }` 1. 1Save the file and restart Claude. 2. 2Ask: “Take a screenshot of this window.” ## Every tool 27 tools on three servers. Names and parameters exactly as your AI sees them. ### On your Mac The `clacky-mcp` helper (stdio). Claude Desktop, Claude Code, Cursor, Codex. Alerts - `notify` Plays Clacky’s agent sound and shows a notification, e.g. when a long task is done or needs you. Params: title, message?, sound?: done | needs | error Screenshots, Grab Text & recording - `take_screenshot` Captures the screen, an area or a window; returns the PNG’s path and a small preview. May ask you first. Params: target?: screen | area | window - `grab_text` Reads the text in a screen area or an image/PDF with Apple’s on-device recognition; returns only text. Params: source?: area | file, path?, languages? - `start_recording` Starts Clacky’s screen recorder (3-second countdown), optionally stopping by itself. Saved to ~/Movies. Params: seconds? (3–600) - `stop_recording` Stops the recording and returns the video’s path. Mac Health - `get_mac_health` CPU, memory pressure, disk space, battery and temperature. No app or process names. Notes & tasks - `add_note` Adds a note to Clacky’s Notes. Params: text - `add_task` Adds a task to today’s (or tomorrow’s) list. Params: text, day?: today | tomorrow - `list_today_tasks` Today’s tasks, and which are done. Focus & Keep Awake - `start_focus` Starts the focus timer. Params: minutes? (1–180) - `stop_focus` Stops the focus timer. - `keep_awake` Keeps the Mac and display awake (for some minutes or until off), optionally with the lid closed. Params: on, minutes?, lid\_closed? Modes - `get_mode` Which mode is on (Record, Code, Focus, Call, Quiet or yours) and the modes there are. - `set_mode` Switches to a mode, or “none” to put everything back. Params: mode (id, name or "none") Social posts (Calendar) - `list_social_accounts` Your connected accounts, account sets, signatures and posts left this month. - `schedule_post` Schedules a post (or posts now, after you say yes in Clacky), with an optional image and signature. Params: text, at, accounts? | set?, captions?, image\_path?, signature? - `list_scheduled_posts` Posts between two dates, with each platform’s status and link. Params: from?, to?, include\_posted? - `cancel_scheduled_post` Cancels what hasn’t gone out yet. Published posts stay up; you can undo it in the Calendar. Params: post\_id Website stats - `get_site_stats` Visitors, pageviews, top sources and pages and revenue for one of your sites. Numbers only. Params: site?, period?: today | yesterday | 24h | 7d | 30d | 90d | 12m - `get_live_visitors` Who’s on your site right now (last 5 minutes): pages and sources, no identities. Params: site? ### Social calendar, online `https://clacky.app/api/social/mcp`. Claude.ai, ChatGPT or any app with custom connectors. Calendar - `list_accounts` Connected accounts, account sets, signatures and platforms still coming soon. - `list_posts` Scheduled and posted posts between two dates, with status and links. Params: from?, to? - `schedule_post` Schedules a post to accounts or a set at a future time, with per-platform captions. Params: text, at, accounts? | set?, captions?, signature? - `post_now` Publishes right away. Only when you clearly asked; needs `confirm: true`. Params: text, confirm, accounts? | set?, captions?, signature? - `reschedule_post` Moves a post that hasn’t gone out to a new time. Params: post\_id, at - `cancel_post` Cancels what hasn’t gone out yet. Published posts aren’t deleted. Params: post\_id - `get_stats` Per-platform stats for 7, 30 or 90 days: posts, likes, comments, shares, visitors and sales. Params: days?: 7 | 30 | 90 ## Privacy and safety - ✓No tool reads keystrokes, typed text or your clipboard. - ✓The Mac tools never upload anything. Screenshots and recordings stay on your Mac; only the file path (and a small preview) goes to your AI app. - ✓Grab Text reads on your Mac with Apple Vision and returns only the text: nothing saved, nothing on the clipboard. - ✓Screenshots ask every time unless you turn on “Screenshots without asking”. An image for a post is only read after you allow it. - ✓Posting now always asks you in Clacky first. A scheduled post shows you a notification and can be cancelled. - ✓Only the social and site tools talk to clacky.app, with your own Clacky sign-in. Your AI never sees a token. - ✓The helper talks to the app over a private local socket that only your user can open. ## Questions What is MCP? The Model Context Protocol: an open standard that lets AI apps such as Claude, Cursor and Codex call tools. Clacky’s MCP server gives them your Mac’s tools. Do I need to install anything else? No. The server is inside Clacky.app. Turn on Settings → Connect AI tools (MCP) and paste one snippet into your AI app. Does Clacky need to be running? Yes. The helper passes each call to the open Clacky app. If Clacky is closed or the switch is off, the AI gets a clear “not available” instead. Can my AI read what I type? No. No tool reads keystrokes, typed text or the clipboard. Can it post without me? Posting now always asks you in Clacky first, and nothing goes out if you say no. Scheduled posts show you a notification and can be cancelled. Does it work with ChatGPT or Claude on the web? For the social calendar, yes: add `https://clacky.app/api/social/mcp` as a custom connector and sign in. The Mac tools need a desktop app (Claude Desktop, Claude Code, Cursor, Codex).