SwarmMarshal
Download · public preview

Free for PC and Apple Silicon Mac.

One desktop app on Windows or M-series Macs, free while SwarmMarshal is in public preview. Connect your work email, personal Gmail or Outlook, iMessage, and team chat — everything syncs to your own machine, not someone else's cloud. Add calendars, the Telegram bridge, agents, skills, and paired devices when the first routines are useful.

Current releases

Windows 1.0.14 / Apple Silicon Mac 1.0.13

SwarmMarshal is ready for early adopters who want to run boss and employee agents across laptops, edge devices, and back-office machines.

Download for Windows Download for Mac (Apple Silicon) Getting started guide Join the community
Cloud AI cost notice

Bring your own API keys, bring your own spending controls.

SwarmMarshal is free during public preview, but cloud LLM providers bill the API keys you add. You are solely responsible for any OpenAI, Anthropic, Google, xAI, DeepSeek, Hugging Face, or other provider charges. Agent loops, retries, long conversations, inbox backfills, large attachments, or misconfigured routes can cause runaway token usage. Set hard spending caps and alerts with each provider before enabling cloud models, and monitor SwarmMarshal's LLM call history while agents run.

Windows .exe installer Auto-update inside the app
macOS Apple Silicon signed zip M-series Macs only
Preview site pulse Free public preview is open
Windows · PowerShell

One-line install

iwr -useb https://swarmmarshal.com/install.ps1 | iex

Opens the getting started guide, pulls the release manifest, verifies the checksum, and runs the signed Windows setup package. Cloud LLM API usage is billed by your provider, so set provider-side caps before adding keys.

macOS · Terminal

One-line install

curl -fsSL --proto '=https' --tlsv1.2 https://swarmmarshal.com/install.sh | bash

The installer checks for an Apple Silicon Mac, opens the getting started guide, downloads the signed macOS package from the manifest, places SwarmMarshal.app in Applications, and opens it. Apple Messages sync uses Full Disk Access for that stable app path. You remain responsible for cloud LLM charges from keys you configure.

Connect mail and calendar

Gmail and Outlook need a one-time OAuth setup.

SwarmMarshal is local-first — Google and Microsoft want you to register your own app for direct mail, calendar, and contacts access. Both walkthroughs are roughly ten minutes.

Connect Gmail, Google Calendar, and Contacts Personal Google Cloud project · ~10 min
→
Connect Outlook, Hotmail, or Microsoft 365 Personal Azure app · ~10 min
→
Take it with you

Put your assistant in your pocket with a private Telegram bot.

Five minutes, no exposed ports, no hosting. Your desktop keeps doing the work; Telegram just carries the conversation — and your morning briefing.

Telegram · one-time setup

Create your private bot

1. In Telegram, message @BotFather → /newbot and copy the bot token.
2. In SwarmMarshal, open Channel Settings → add Telegram → paste the token and put your own Telegram user ID in Allowed user IDs so the bot answers only you.
3. Message your bot /start, then ask it anything your desktop knows.

Telegram · daily briefing

Get the briefing on your phone

Text the bot /briefing on once and each morning's briefing is delivered to that chat after it's generated — calendar, commitments, and mail highlights, with sources waiting on the Today page. /briefing now sends today's on demand; /briefing off stops it.

Wire it to your agent

Plug SwarmMarshal into Claude Code or Codex as an MCP server.

Once your accounts are connected, point your MCP-aware client at the bundled SwarmMarshal.McpServer. Your agent gets ~40 typed tools — context packs, thread and person history, search, compose, and act — across every inbox at once.

Claude Code

Add to mcp.json

{
  "mcpServers": {
    "swarmmarshal": {
      "command": "SwarmMarshal.McpServer"
    }
  }
}

The installer creates a SwarmMarshal.McpServer command shim on your PATH. Set SwarmMarshal_DATA_DIR in env if you use a non-default profile.

Codex CLI

Add to Codex config

{
  "mcp": {
    "servers": {
      "swarmmarshal": { "command": "SwarmMarshal.McpServer" }
    }
  }
}

Codex launches the binary on stdio and discovers the tool catalog on handshake. No keys, no HTTP, no remote service.

Full MCP walkthrough Architecture deep dive
Using more than one computer?

SwarmSpan lets your Macs and PCs work together.

Pair your own computers over the local network, copy on one machine, paste on the other, and give your agent a private path to move files or assign work when the other device has the right tools.

Get SwarmSpan