Skip to main content
Alter connects to your Mac in several distinct ways:
  • 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
Recommended: install a specialized agent from the Alter Marketplace — the live ChatGPT Agent is available now; Cursor, Claude, and OpenCode agents are coming soon. On first run, Alter enables the required coding tool automatically. Alter starts these sessions in the background from the Hub or an action, then returns results into the same conversation. Coding tools use a constrained permission profile mapped from your workspace — they do not require Alter Full Access for authorized project folders.

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.