Skip to content

jasonpaulso/altic-mcp

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Altic MCP

An MCP server that gives Claude hands-on control of your Mac, what Siri should've been

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

Requirements

Quick Start

Option 1: Install as UV Tool (Recommended)

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

# Install altic-mcp as a tool
git clone https://github.com/altic-dev/altic-mcp.git
cd altic-mcp
uv tool install .

# Test it works
altic-mcp-server

Option 2: Local Development Setup

# 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

Using UV Tool Install (Recommended)

After installing as a UV tool, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "altic-mcp": {
      "command": "altic-mcp-server"
    }
  }
}

Using Local Path

1. Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "altic-mcp": {
      "command": "uv",
      "args": ["run", "/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.

About

Turn Claude into a better version of Siri

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 46.9%
  • AppleScript 43.4%
  • Swift 9.7%