macOS automation with Model Context Protocol

Turn Claude into your Mac command center

Altic MCP is an open-source bridge that gives AI assistants practical control over macOS apps. Run messages, notes, reminders, Safari, calendar etc.

Star on GitHub Setup in 4 steps Explore tool surface

Install the skill

npx skills add altic-dev/altic-mcp

MCP Tools

Across Safari, messages, notes, calendar, and system control.

Skill Scripts

The altic-studio skill adds script-first automation workflows.

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.

contact matched -> message sent

command

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

calendar event created

command

Open Safari, switch to tab 3, summarize this page.

tab switched -> page info fetched

Demo sessionReal workflow capture

Tool surface

27 MCP tools across six automation domains

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

View tool definitions

12 tools

Safari Automation

Full browser control for tabs, navigation, JavaScript execution, and page inspection.

Open, close, and switch Safari tabs
Navigate, reload, and history controls
Run JavaScript directly in active tab
Get URL, title, text, and page source

3 tools

Messages & Contacts

Search contacts, read recent conversations, and send iMessages from Claude.

Search contacts by name
Read recent messages by phone number
Send iMessage with direct context
Supports quick clarification workflows

3 tools

Notes & Reminders

Capture ideas and automate follow-ups with natural language and structured times.

Create notes with optional folders
Search notes with max result controls
Set reminders with date and list support
Input format validation built in

2 tools

Calendar Management

Schedule events and query daily agenda with explicit time and duration control.

Create events using YYYY-MM-DD HH:MM
List all events for a specific day
Supports default or named calendars
Date-time guardrails prevent malformed input

5 tools

System Controls

Control apps and core machine settings, including brightness and output volume.

Open any macOS app by name
Increase or decrease brightness
Turn system volume up or down
Uses AppleScript for native behavior

2 tools

Visual Feedback

Show when automation is active by adding and removing a screen glow indicator.

Add screen glow before long actions
Remove glow when tasks complete
Clear status signal for automation runs
Helps reduce silent background actions

Altic Studio skill

Execute local AppleScript automations through the altic-studio skill with a deterministic command template. Great for repeatable workflows and fast OpenCode execution.

Messaging

send-message + read-recent-messages

Safari

tabs, navigation, page info, JavaScript

Productivity

notes, reminders, calendar event flows

System

apps, volume, brightness, visual feedback

Calendar

create events and list daily timeline

Screenshots

capture-screenshot.applescript

Command template

osascript "skills/altic-studio/scripts/script.applescript" [arg1] [arg2]

Setup flow

Production-ready setup in four 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 runtime requirements

Install Python 3.13+ and uv package manager on macOS.

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

Step 02

Clone and sync

Clone the repository and install dependencies with uv sync.

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

Step 03

Wire into Claude Desktop

Add the altic-mcp server command inside claude_desktop_config.json and restart Claude Desktop.

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

Step 04

Enable permissions

Grant Contacts, Calendars, Reminders, Automation, Accessibility, and Safari JavaScript permissions.

System Settings -> Privacy & Security

Full permission checklist

macOS permissions to enable once

Contacts access for contact search

Calendars access for event creation and listing

Reminders access for schedule automation

Automation access for Messages, Notes, and Safari

Accessibility for system controls and overlays

Safari Develop menu: Allow JavaScript from Apple Events

Screen Recording when using screenshot scripts

Full Disk Access for Messages database reading

FAQ

Common questions before you ship

Does Altic MCP work only with Claude Desktop?

No. The MCP server is compatible with any MCP client. Claude Desktop is the most common setup, and altic-studio gives you script-first execution in OpenCode.

Can I automate Safari actions end to end?

Yes. You can open and switch tabs, navigate pages, run JavaScript, inspect current page info, and drive browser history without manual clicks.

What is new in the skill layer?

The altic-studio skill exposes 26 AppleScript automations, including screenshot capture, and is built for direct osascript execution from your project workspace.

Is this secure enough for daily use?

Altic MCP is local-first and explicit-permission based. macOS prompts for each privileged integration, so you control exactly what the assistant can access.

Do I need coding experience to set this up?

Basic terminal comfort is enough. The setup is mostly copy-paste commands plus macOS privacy permissions, and the README includes the full configuration template.

Launch-ready MCP stack

Ship reliable Mac automation with a modern, searchable MCP landing page

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

Open repository Start setup