Atlas / MCP servers / ashwwwin / Automation

AutomationCAUTION

Name: Automation
Author: ashwwwin

mcp/ashwwwin/automation

MCP server by ashwwwin · mcp · mcp server · Audited 2026-10-01

⚑ Report / re-scan Source ↗

Control your Mac with detailed mouse, keyboard, screen, and window management capabilities.

Verdict

CAUTION

Grade

Trust score

81 /100

Exposed tools

20 16r · 4w · 0d

Transport

—

License

MIT

Stars

415

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

Automation MCP is a Model Context Protocol (MCP) server that provides AI models with complete desktop automation capabilities on macOS. It enables AI assistants to:

🖱️ Control your mouse (click, move, scroll, drag)
⌨️ Type and send keyboard input (including system shortcuts)
📸 Take screenshots and analyze screen content
🪟 Manage windows (focus, move, resize, minimize)
🎯 Interact with UI elements through coordinates
🎨 Analyze screen colors and highlight regions
🔍 Wait for images to appear on screen

🚀 Quick start

Make sure you have furi installed, and then run the following command:

furi add ashwwwin/automation-mcp

followed by:

furi start ashwwwin/automation-mcp

and you're done! (or you can just use the furi desktop app for no cli).

🥲 Normal start (without furi)

Prerequisites

Bun runtime - Install with: curl -fsSL https://bun.sh/install | bash

1. Clone and Install

git clone https://github.com/ashwwwin/automation-mcp.git
cd automation-mcp
bun install

2. Start the Server

# Start with HTTP transport (recommended for web apps)
bun run index.ts

# Or start with stdio transport (for command line tools)
bun run index.ts --stdio

3. Grant Permissions

On first run, macOS will ask for permissions. You must grant these for full functionality:

Accessibility - Allows keyboard/mouse control
Screen Recording - Enables screenshots and screen analysis

Or manually enable in: System Settings → Privacy & Security → Accessibility/Screen Recording

🛠️ Available Tools

🖱️ Mouse Control

mouseClick - Click at coordinates with left/right/middle button
mouseDoubleClick - Double-click at coordinates
mouseMove - Move cursor to position
mouseGetPosition - Get current cursor location
mouseScroll - Scroll in any direction
mouseDrag - Drag from c

Read from source at commit e1f422ed5dc7OBSERVED · 2026-10-01

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code

claude mcp add automation-mcp -- npx -y [email protected]

claude-desktop

{
  "mcpServers": {
    "automation-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

Exposed tools (20)

16 read · 4 write · 0 destructive.

Tool	Risk	Description
`colorAt`	read	Get the color of a pixel at specific screen coordinates.
`getActiveWindow`	read	Get information about the currently active window.
`getWindows`	read	Get information about all open windows.
`keyControl`	read	Press or release specific keys for advanced key combinations.
`mouseButtonControl`	read	Press or release a mouse button without clicking.
`mouseClick`	read	Simulate a mouse click at the given screen coordinates.
`mouseDoubleClick`	read	Simulate a mouse double-click at the given screen coordinates.
`mouseDrag`	read	Drag the mouse from current position to target coordinates.
`mouseGetPosition`	read	Get the current mouse cursor position.
`mouseMove`	write	Move the mouse to specific coordinates.
`mouseMovePath`	write	Move mouse along a path of coordinates with smooth animation.
`mouseScroll`	read	Scroll the mouse wheel in a specified direction.
`screenHighlight`	read	Highlight a region on the screen for visual feedback.
`screenInfo`	read	Get screen dimensions and information.
`screenshot`	read	Capture a screenshot (full screen, region, or window). Default to full screen if no preference. This will also provide information about the user
`sleep`	read	Pause execution for a specified amount of time.
`systemCommand`	write	Execute common system key combinations (copy, paste, undo, etc.).
`type`	read	Simulate typing text or pressing key combinations. Provide either
`waitForImage`	read	Wait for an image to appear on screen and return its location.
`windowControl`	write	Control a window (focus, move, resize, minimize, restore).

Trust audit

CAUTIONgrade B · trust 81/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	WARN
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (5 observation(s))
Network: none-observed
Shell: declared (5 observation(s))
Dependencies: not all pinned
Secrets in source: none-found

Findings (19)

MEDIUMInventory / provenance · inv.binary · CWE-1104

nutjs/libnut-core/build/Release/libnut.node

libnut.node

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

MEDIUMInventory / provenance · inv.binary · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/.DS_Store

.DS_Store

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

MEDIUMInventory / provenance · inv.binary · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/linux/xsel

xsel

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

MEDIUMInventory / provenance · inv.binary · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/windows/.DS_Store

.DS_Store

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

MEDIUMInventory / provenance · inv.binary · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/windows/clipboard_i686.exe

clipboard_i686.exe

Why it matters. a compiled or binary member cannot be reviewed from source

Fix. ship source, or explain the binary in the README

LOWInventory / provenance · inv.hidden_file · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/.DS_Store

.DS_Store

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWInventory / provenance · inv.hidden_file · CWE-1104

nutjs/nut.js/node_modules/clipboardy/fallbacks/windows/.DS_Store

.DS_Store

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

nutjs/nut.js/core/nut.js/dist/lib/expect/matchers/toBeAt.function.d.ts:1

import { MouseClass } from "../../mouse.class";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

nutjs/nut.js/core/nut.js/dist/lib/expect/matchers/toBeIn.function.d.ts:1

import { MouseClass } from "../../mouse.class";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

nutjs/nut.js/core/nut.js/dist/lib/expect/matchers/toHaveColor.function.js:4

const index_1 = require("../../../index");

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

nutjs/nut.js/core/nut.js/dist/lib/expect/matchers/toShow.function.d.ts:1

import { ScreenClass } from "../../screen.class";

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

nutjs/nut.js/core/nut.js/dist/lib/expect/matchers/toShow.function.js:5

const index_1 = require("../../../index");

LOWSupply chain · supply.unpinned · CWE-829, CWE-1357

nutjs/nut.js/node_modules/arch/package.json

airtap, standard, tape

Why it matters. 3 dependency range(s) float