macOS automation with Model Context Protocol

Turn Claude into your Mac command center

Altic MCP turns Claude into a hands-on Mac operator. Connect 37 precise tools for Messages, Contacts, Notes, Reminders, Calendar, 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 Safari, Chrome CDP, messages, notes, calendar, screen capture, and system control.

Skill Scripts

26 AppleScript automations plus one Swift active-screen capture utility.

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

Claude + MCP + macOS

command

Find Sam in contacts and send an iMessage: Running 10 mins late.

search_contacts -> send_imessage

command

Create tomorrow 9:30 AM standup in Work calendar for 30 minutes.

create_calendar_event

command

Open a Chrome session, navigate to GitHub, wait for a selector, and extract page text.

chrome_open_session -> chrome_navigate -> chrome_wait_for -> chrome_extract

command

Capture my active display and attach the screenshot for review.

capture_active_screen

Demo sessionReal workflow capture

Tool surface

37 MCP tools across eight automation domains

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

View tools JSON

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

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 two execution modes: AppleScript for macOS app automation and MCP CDP for deterministic Chrome browser control.

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

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]chrome_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, Accessibility, Screen Recording, Safari JavaScript from Apple Events, and Chrome access as needed.

System Settings -> Privacy & Security

Required permissions

Contacts for search_contacts
Calendars for calendar events
Reminders for creating reminders
Automation so Claude can control apps such as Messages, Notes, and Safari
Accessibility for screen glow and system controls
Screen Recording for screenshot capture tools
Safari -> Develop -> Allow JavaScript from Apple Events for Safari tools
Google Chrome for Chrome CDP tools

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 20+ tools. The current server.py source exposes 37 exact MCP tools.

Which automation areas are covered?

Altic MCP covers Messages and Contacts, Notes and Reminders, Calendar, 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, 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, Accessibility, and Screen Recording are required for the corresponding macOS integrations. 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