Altic MCP

Features

20+ tools for macOS automation:

• 📱 Messages & Contacts - Send/read iMessages, search contacts
• 📝 Notes & Reminders - Create and search notes, set reminders
• 📅 Calendar - Create and view events
• 🌐 Safari - Control tabs, navigate, execute JavaScript
• 🖥️ System - Open apps, adjust brightness/volume, visual effects

Available Skills

This repo currently includes one shareable skill:

• altic-studio (skills/altic-studio/)
  • Runs local AppleScript automations via osascript through the Bash tool
  • Covers Messages, Contacts, Notes, Reminders, Calendar, Safari, system controls, and screenshots
  • Main skill manifest: skills/altic-studio/SKILL.md

Key Scripts In altic-studio

• Messaging: send-message.applescript, read-recent-messages.applescript
• Contacts: fetch-all-contacts.applescript
• Notes/Reminders: create-note.applescript, search-for-note.applescript, set-reminder.applescript
• Calendar: create-calendar-event.applescript, list-all-calendar-events-for-day.applescript
• Safari: open/close/switch/navigate/reload/history/page-info scripts
• System: open-application.applescript, brightness + volume scripts
• Screenshot: capture-screenshot.applescript

Skill Setup (OpenCode)

To make altic-studio available in OpenCode, symlink it into your OpenCode skills directory:

mkdir -p "$HOME/.config/opencode/skills"
ln -sfn "/Users/rohith/Documents/altic-mcp/skills/altic-studio" "$HOME/.config/opencode/skills/altic-studio"
ls "$HOME/.config/opencode/skills"

Then restart OpenCode (new session).

Requirements

• macOS 10.13+
• Python 3.13+
• UV package manager

Quick Start

# Install UV if needed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and setup
git clone https://github.com/altic-dev/altic-mcp.git 
cd altic-mcp
uv sync

# Test locally
uv run server.py

Setup with Claude Desktop

1. Edit ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "altic-mcp": {
      "command": "uv",
      "args": ["run", "--project", "/FULL/PATH/TO/altic-mcp", "/FULL/PATH/TO/altic-mcp/server.py"]
    }
  }
}

Replace /FULL/PATH/TO/altic-mcp with your actual path (e.g., /Users/johndoe/Documents/altic-mcp).

2. Restart Claude Desktop (Command + Q, then reopen)

3. Look for the 🔨 hammer icon in the chat interface to see available tools

Permissions Required

System Preferences → Privacy & Security:

• ✅ Contacts - For search_contacts
• ✅ Calendars - For calendar events
• ✅ Reminders - For creating reminders
• ✅ Automation - Allow Claude to control apps (Messages, Notes, Safari)
• ✅ Accessibility - For screen glow and system controls

Safari Settings:

Safari → Develop → Allow JavaScript from Apple Events ✅ (Required for Safari tools)

Note: If "Develop" menu is not visible, enable it in Safari → Settings → Advanced → Show Develop menu

macOS will prompt for permissions when first used. Grant them to enable full functionality.