macOS automation with Model Context Protocol

Turn Claude into your Mac command center

Altic MCP turns Claude into a hands-on Mac operator. Connect 64 precise tools for Messages, Contacts, Notes, Reminders, Calendar, Files, Finder, Clipboard, Window & Workspace, Safari, Chrome CDP, screen capture, system controls, and visual feedback, all through an open source Model Context Protocol server for macOS.

Star on GitHub Setup in 5 steps Explore tool surface

Install the skill

npx skills add altic-dev/altic-mcp

Markdown reference Tools JSON

MCP Tools

Across files, Finder, clipboard, windows, Safari, Chrome CDP, messages, notes, calendar, screen capture, and system control.

Skill Scripts

26 AppleScript automations plus Swift utilities for screenshots, clipboard, and window management.

Open Source

Apache-2.0

Inspect, extend, and self-host without lock-in.

Runtime

Python 3.13+

FastMCP server with uv setup on macOS 10.13+.

Live command flow

codex-agent / altic-mcp

user

Text Sam that I am running 10 minutes late, then show me the latest messages.

agent

Resolving the contact, sending the message, then checking the thread.

tool:1search_contacts

name: "Sam"

Matched Sam Rivera with one iMessage-capable number.

tool:2send_imessage

message: "Running 10 minutes late."

Message delivered through Messages.

tool:3read_recent_messages

recent_message_count: 5

Latest thread returned for review.

Action completed successfully

Sam was found, the message was sent, and the latest conversation context is ready.

Demo sessionReal workflow capture

Tool surface

64 MCP tools across eleven automation domains

Each tool maps to predictable macOS behaviors, so prompts stay natural while execution stays deterministic.

3 tools

Messages & Contacts

Send and read iMessages, search contacts, and resolve phone numbers.

Find people and resolve phone numbers
Send and review iMessage conversations
Handle clarification flows before acting

3 tools

Notes & Reminders

Create and search Apple Notes, then create time-based reminders.

Capture notes into Apple Notes
Search saved notes by query
Create dated reminders in the right list

2 tools

Calendar

Create Calendar events and list events for a specific day.

Create events with exact time and duration
Review a day of scheduled events
Target default or named calendars

10 tools

Files & Finder

Find, inspect, copy, move, rename, reveal, and trash files safely, with dry-run support for destructive-looking actions.

Find files with Spotlight or name search
Inspect, copy, move, and rename paths
Use dry runs before Trash or overwrite actions

7 tools

Clipboard

Read, write, clear, save, and set macOS clipboard text, files, and images.

Read and write clipboard text
Copy file paths for Finder paste
Save and set clipboard images

10 tools

Window & Workspace

Inspect, focus, move, resize, center, tile, minimize, hide, and quit macOS app windows.

Inspect frontmost apps and windows
Focus, move, resize, and center windows
Tile apps or hide and quit them

12 tools

Safari

Control Safari tabs, windows, navigation, history, JavaScript, and page inspection.

Control tabs, windows, and navigation
Inspect page title, text, URL, and source
Run JavaScript through Apple Events

9 tools

Chrome CDP

Use session-based Chrome DevTools Protocol control for navigate, wait, click, type, extract, screenshot, and close workflows.

Open deterministic browser sessions
Wait, click, type, and navigate by selector
Extract page data and capture screenshots

1 tools

Screen Capture

Capture the active display and return image output directly to the model.

Capture the active display
Return image output directly to the model
Save screenshots to an optional path

5 tools

System

Open apps and adjust brightness or system volume.

Open macOS apps by name
Adjust brightness and system volume
Use native macOS automation paths

2 tools

Visual Feedback

Add and remove a screen glow so the user can see when automation is active.

Show automation is actively running
Remove status glow when work completes
Keep background actions visible to users

Altic Studio skill

The altic-studio skill now supports five execution modes: AppleScript for macOS app automation, MCP tools for Chrome browser control, MCP file workflows, MCP clipboard operations, and MCP window/workspace management.

Messaging

send-message + read-recent-messages

Safari

tabs, navigation, page info, JavaScript

Chrome CDP

open session, wait, click/type, extract, screenshot

Productivity

notes, reminders, and calendar event flows

Files/Finder

find, inspect, copy, move, reveal, and Trash

Clipboard

text, file paths, image save, and image set

Workspace

frontmost app, list, focus, move, resize, center, tile

System

apps, volume, brightness, visual feedback

Screenshots

capture-screenshot.applescript + capture-active-screen.swift

Execution templates

osascript "skills/altic-studio/scripts/script.applescript" [arg1] [arg2]swift "skills/altic-studio/scripts/clipboard.swift" get-filesswift "skills/altic-studio/scripts/window-manager.swift" list_windowschrome_open_session -> chrome_navigate -> chrome_wait_for -> chrome_extract

Setup flow

Production-ready setup in five steps

The sequence below follows the current README and aligns with the latest tool and skill architecture in altic-dev/altic-mcp.

Step 01

Install UV if needed

Run this command from the source README setup flow.

curl -LsSf https://astral.sh/uv/install.sh | sh

Step 02

Clone and set up the repository

Run this command from the source README setup flow.

git clone https://github.com/altic-dev/altic-mcp.git && cd altic-mcp && uv sync

Step 03

Test locally

Run this command from the source README setup flow.

uv run server.py

Step 04

Configure Claude Desktop

Add the MCP server command inside claude_desktop_config.json and restart Claude Desktop.

uv run --project /FULL/PATH/TO/altic-mcp /FULL/PATH/TO/altic-mcp/server.py

Step 05

Enable permissions

Grant Contacts, Calendars, Reminders, Automation, Finder Automation, Accessibility, Screen Recording, Safari JavaScript from Apple Events, and Chrome access as needed.

System Settings -> Privacy & Security

FAQ

Common questions before you ship

What is Altic MCP?

Altic MCP is an open source Model Context Protocol server that lets MCP clients automate macOS apps and browser sessions.

How many tools does Altic MCP expose?

The README describes 40+ tools. The current server.py source exposes 64 exact MCP tools.

Which automation areas are covered?

Altic MCP covers Messages and Contacts, Notes and Reminders, Calendar, Files and Finder, Clipboard, Window and Workspace, Safari, Chrome CDP, Screen Capture, System controls, and Visual Feedback.

What is altic-studio?

altic-studio is the shareable skill in the Altic MCP repo. It runs AppleScript automations via osascript and supports Messages, Contacts, Notes, Reminders, Calendar, Files and Finder workflows, Clipboard operations, Window and Workspace management, Safari, system controls, screenshots, and Chrome CDP browser control.

What are the requirements?

Altic MCP requires macOS 10.13+, Python 3.13+, the UV package manager, and Google Chrome for Chrome CDP tools.

What permissions are required?

Contacts, Calendars, Reminders, Automation, Finder Automation, Accessibility, and Screen Recording are required for the corresponding macOS integrations. Clipboard file and image operations may prompt depending on host app and OS settings. Safari tools also require Safari's Allow JavaScript from Apple Events setting.

Launch-ready MCP stack

Enable reliable Mac automation

Clone the repo, enable permissions once, and run intelligent desktop workflows from Claude Desktop or OpenCode with clear observability.

Open repository Start setup