1.  [Features](https://clacky.app/features/)
2.  ›
3.  [AI & MCP](https://clacky.app/features/#ai-mcp)
4.  ›
5.  Command line

AI & MCPLive

# Command line

Any agent with a shell, or your own scripts, can call the same 14 tools with the clacky-mcp command. For example:

`/Applications/Clacky.app/Contents/MacOS/clacky-mcp call notify '{"title":"Build passed"}'`

[Try free for 7 days](https://clacky.app/try/)

![Command line in Clacky](https://clacky.app/features27/cli-cmd-light.webp)![Command line in Clacky](https://clacky.app/features27/cli-cmd-dark.webp)

## What it is

No MCP in your agent? The clacky-mcp command inside the app runs the same 14 tools from Terminal, so a script or any agent that runs commands can alert you, keep the Mac awake or grab text.

It follows the same switches as Connect AI tools: a tool you turned off stays off here too, and screenshots still ask you first.

## How to use it

1.  1
    
    Turn on AI tools
    
    Turn on Settings → Connect AI tools in Clacky.
    
2.  2
    
    See what’s on
    
    Run /Applications/Clacky.app/Contents/MacOS/clacky-mcp list to see the tools you turned on.
    
3.  3
    
    Call a tool
    
    Run clacky-mcp call with the tool’s name and its arguments as JSON, like the notify example on this page.
    

## Tips

-   clacky-mcp prints the text result. It exits with 1 when Clacky or you said no (the reason is on stderr) and with 2 on bad usage, so scripts can check.

## Questions

Does Clacky need to be running?

Yes. If Clacky isn’t running or a tool is switched off, the command says so and exits with an error.

Which tools can I call?

The same 14 as over MCP: notify, take\_screenshot, grab\_text, start\_recording, stop\_recording, get\_mac\_health, add\_note, add\_task, list\_today\_tasks, start\_focus, stop\_focus, keep\_awake, get\_mode and set\_mode.

Related features

-   ![](https://clacky.app/features27/connect-ai-light.webp)![](https://clacky.app/features27/connect-ai-dark.webp)
    
    [Connect AI tools](https://clacky.app/features/connect-ai/)
    
    Turn on Settings → Connect AI tools and add Clacky to Claude, Claude Code, Cursor or Codex with one line. For Claude Code:
    
-   ![](https://clacky.app/features27/skill-cmd-light.webp)![](https://clacky.app/features27/skill-cmd-dark.webp)
    
    [Clacky skill](https://clacky.app/features/skill/)
    
    A SKILL.md that tells Claude Code when to use which Clacky tool. One command installs it:
    
-   ![](https://clacky.app/features27/mcp-tools-light.webp)![](https://clacky.app/features27/mcp-tools-dark.webp)
    
    [Alerts and Keep Awake](https://clacky.app/features/mcp-alerts/)
    
    Your agent can tell you when a long task is done or needs you, and keep the Mac awake while it works.
    

[Everything in AI & MCP →](https://clacky.app/features/#ai-mcp)

## Make something on your Mac today.

Seven days free, every feature, cancel anytime.

[Try free for 7 days](https://clacky.app/try/)