- Mac Apps (local tools) — First-party integrations with Mail, Calendar, Messages, Notes, Reminders, Contacts, Maps, Apple Shortcuts, DEVONthink, Computer Use, and Coding (ChatGPT, Cursor, OpenCode, Claude Code). These run on your Mac with system permissions; no third-party API keys required for the built-in apps.
- Gateways — Use Alter from compatible AI agents through MCP Gateway, or chat with Alter through Discord and Telegram bots, while Alter runs on your Mac. Internal builds also support a Buzz gateway (internal) for the dev team. Configure under Settings → Integrations → Gateways.
- External integrations — MCP servers, skills, and cloud connectors (Slack, Notion, GitHub, web search APIs, etc.) configured in Tools Manager.
Choose the right integration type
- Use Mac Apps when the workflow stays on your Mac (inbox triage, calendar updates, iMessage, screen automation).
- Use Gateways when you want to talk to Alter from an MCP-compatible AI agent, Discord, or Telegram without opening the Hub. Internal builds can also connect Buzz — see Buzz gateway (internal).
- Use external integrations when data or actions live in another service or the open web.
Gateways
Connect MCP agents, Discord, and Telegram to Alter
Remote MCP server
Connect a compatible AI agent using your private Alter MCP URL
Alter in ChatGPT
Enable MCP Gateway and install the ChatGPT desktop plugin
Discord setup
Step-by-step Discord bot setup
Telegram setup
Step-by-step BotFather setup
Buzz setup (internal)
Join a Buzz community — dev team only, internal builds
Local tools (Mac Apps)
Local tools run in your environment and are best for daily execution on Apple apps, coding agents, and Computer Use. Recent Mac app capabilities (beta121+) include:- Mail — List mailboxes and search messages by sender, subject, mailbox, date, or read status (metadata only; open full bodies with the existing read tool)
- Messages — Search iMessage history by participant, text, date, or unread status; read downloaded attachments from search results (requires Full Disk Access for Alter)
- Calendar — Add attendees and FaceTime links when creating or updating events
- Reminders — Rename or delete reminder lists (delete requires explicit confirmation)
- Contacts — Read your Me contact card
- Maps — Geocode addresses and reverse-geocode coordinates (in addition to search, directions, and explore)
- Apple Shortcuts — List shortcuts on your Mac, inspect expected inputs before running, and run a shortcut with text or local files as Shortcut Input
Mac Apps nav
Per-app references: Mail, Calendar, Messages, Notes, and more
Coding tools
ChatGPT, Cursor, OpenCode, and Claude Code from Alter
Computer Use
Goal-based screen automation agent
Coding tools
The Coding category in Tools Manager → Local Tools connects Alter to local coding agents you already run on your Mac:- ChatGPT — persistent tasks through the ChatGPT desktop app (Codex)
- Cursor — sessions through the Cursor Agent CLI
- OpenCode — CLI and terminal sessions, including work started outside Alter
- Claude — Claude Code CLI sessions
Coding tools workflow
Setup, permissions, provider comparison, and troubleshooting
Free to use
Local tools are included.
Private by default
Local workflows stay on your Mac.
App control
Alter can execute app actions, not only summarize data.
Offline-friendly
Many local actions work without external services.
Enable local tools
1
Open Tool Manager
In Alter, open the three-dot menu and select Tools Manager.
2
Enable only what you need
Turn on the relevant local tools for the workflow you are running.
3
Test with one prompt
Run a small prompt to confirm permissions and expected behavior.
External integrations
External integrations connect Alter with services such as Slack, Notion, GitHub, and research APIs via Tools Manager → Remote MCP Servers or installed skills.- Use these when your workflow spans multiple systems outside macOS built-ins.
- Enable only the services required for your current task.
- Mac App workflows (Mail, Calendar, Messages) do not require external connectors — see the Mac Apps section in this tab.
Popular workflow entry points
Manage calendar
Plan and update your schedule from Alter.
Mail workflows
Draft replies and process inbox tasks.
Messages workflows
Send and manage iMessages faster.
Computer Use workflow
Extract and summarize visible UI content.