clacky
Back to Clacky
Model Context Protocol · built into Clacky

Clacky MCP

MCP is how AI apps use tools. Clacky has an MCP server built in, so Claude, Cursor or Codex can take a screenshot, read text off your screen, record, ping you when a task is done or schedule a post, right on your Mac.

claude mcp add --scope user clacky -- /Applications/Clacky.app/Contents/MacOS/clacky-mcp

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).