sommus-laptop
Provides email tools over IMAP/SMTP: search, read, send, reply, draft, and mark read on a Gmail account using an app password.
Sends iMessages from the Mac, always confirming before the message is sent.
Controls the Mac: sound, display brightness, apps, browser tabs, clipboard, reminders, notifications, Wi-Fi, sleep, screenshots, keyboard input, and more.
Manages an Obsidian vault: search, read, list, append notes, add to-dos, and commit the notes repo.
Controls Spotify playback — volume, mute, play/pause/skip, and now-playing info — through macOS media control.
Allows messaging the assistant through Telegram, with a bot token, allowed chat IDs, and commands like /new and /cost.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sommus-laptop study mode: close Messages, open Obsidian, volume 10"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sommus
A personal assistant that controls my devices. Named after Somnus, the Roman god of sleep.
Type, text it on Telegram, or just talk to it: Sommus controls my MacBook, answers questions, and reaches my mail, notes and calendar. Next up: an always-on brain in the cloud, then speakers and custom hardware.
What a session looks like (illustrative):
you › study mode: close messages, open obsidian, volume 10
→ quit_app(name="Messages")
✓ Asked Messages to quit.
→ open_app(name="Obsidian")
✓ Opened Obsidian.
→ set_volume(level=10)
✓ Volume 10%.
sommus › Study mode is on: Messages closed, Obsidian open, volume at 10.
4 steps · 9,812 in (7,904 cached) · 212 out · $0.0141Measured, not guessed
Everyday commands (volume, apps, music, weather, "where's my next class") | $0, ~0.1 s, no model call |
Commands that need the model | ~0.5–1¢, 3–5 s (Sonnet 5, low effort) |
Prompt tokens served from cache | 89% |
Class and room questions | 20–27 s → under 1 ms (schedule engine instead of two calendar lookups) |
Tool-call accuracy | 45/46 on the eval suite (Sonnet 5); Haiku 4.5 41/46 at 0.26¢ |
Full numbers, regenerated from the log with sommus stats: docs/MEASUREMENTS.md.
Why it's built this way: docs/decisions — MCP nodes, permission tiers and the PIN,
the model sweep, no local LLM, one model with a budget guard instead of per-request routing, and the
fast path.
Related MCP server: Apple MCP Server
What it can do
60+ tools across five nodes, plus live web search:
Area | Tools |
Sound | volume, mute, play, pause, skip, what's playing |
Display | brightness, screen off, lock |
Apps | list open apps, open, quit, focus, any keyboard shortcut |
Web & files | open a URL, Spotlight search, read a file or folder, append a line, open a file |
Clipboard | read, write |
Reminders | create (syncs to iPhone), list |
Notes vault | search, read, append, add to the to-do list, commit |
search, read, send, reply, draft over IMAP/SMTP | |
System | battery, Wi-Fi status and toggle, sleep, notifications |
Browser | list Chrome tabs, read a tab's text, list its links, click a link or button, switch tabs |
Seeing & typing | screenshot (an image the model looks at), click at its coordinates, type any text, any keystroke, wait |
Documents | read a PDF as text — scanned pages go through macOS Vision OCR |
Contacts | look up anyone's number or email from the Contacts app |
Downloads | fetch a file straight to disk, or save a logged-in page with Cmd+S |
Messaging | send an iMessage, send or draft a Gmail |
Escape hatch | run any of the user's macOS Shortcuts — Focus modes, Home devices, anything macOS won't script |
Knowledge | web search for weather, news, prices, anything after the model's cutoff |
It answers questions as readily as it acts, and when there's no exact tool it tries the nearest route (a Shortcut, a keystroke, opening the right settings pane) before saying it can't.
Without a model
Fast path (
brain/fastpath.py): an intent claims a request only when every word is in its vocabulary — "brightness down 12", "screen's too dim", "quit Messages", "what's playing", weather and time anywhere, holidays, the to-do list. "A bit more" continues whichever level was just changed. A miss just goes to the model; a wrong match would do the wrong thing, so it leans towards missing.Campus engine (
brain/campus.py): next class, room, what's left today and what's due this week, from a schedule file.sommus todayprints the day and writesdata/today.jsonfor other tools.Long-term memory (
brain/memory.py): "remember my gym days are Monday, Wednesday and Friday" is saved to a private note and loaded into the cached prompt. Anything that looks like a password or code is refused.Budget guard (
brain/budget.py): a heads-up at 80% of the monthly cap, a cheaper model past 90%.
Safety, in code
PIN gate (
brain/pin.py): email, messages, files, the shell and Claude Code wait for a PIN said or typed; it never reaches the model or the log, and a PIN typed in Telegram is deleted from the chat.Outside content can't act on its own (
brain/loop.py): once a request has read mail, a web page, a PDF or the screen, sending, replying, the shell and Claude Code run only if the request itself asked for that — so text planted for an AI can't make it send anything (decision 7).
Nodes
Node | Tools | Setup |
laptop | 46 — sound, display, apps, browser, screen, shell, PDFs, contacts, files, clipboard, reminders, shortcuts | macOS permissions (below) |
vault | 9 — search, read by section, list, append, add a to-do, commit, remember, forget | none |
gmail | 6 — search, read, send, reply, draft, mark read | app password in |
web | 1 — search through a cheap worker model, so results never bloat the main context | API key |
claude | 1 — hands a request to Claude Code for Google Calendar, Drive and Notion | Claude Code installed |
A node that isn't set up reports as unreachable; everything else keeps working.
Sommus on your phone (Telegram)
The brain doesn't change — Telegram is a second interface over the same event stream.
Message @BotFather on Telegram, send
/newbot, pick a name, copy the token.Put it in
.envasTELEGRAM_BOT_TOKEN=...and leaveTELEGRAM_ALLOWED_IDSempty for now.Start Sommus, message your bot once, and it prints your chat id:
sommusPut that id in
TELEGRAM_ALLOWED_IDSand restart. Anyone not on that list is ignored and logged — without it, whoever finds the bot could drive the laptop.
Plain sommus answers the terminal and Telegram together, sharing one conversation — a lock keeps a
phone command and a typed one from interleaving. /new starts fresh, /cost reports the day's spend.
Keeping it running
The terminal session stops when its window closes. For Telegram only, detached:
sommus start # background, survives closing the window
sommus status # is it alive, plus the last log lines
sommus stopNot a LaunchAgent on purpose: macOS ties Accessibility and Automation permissions to the responsible
app, which for a launchd job is the bare Python binary — every grant would have to be redone, and
prompts would appear with nobody there to click them. Started from Terminal, the process inherits
Terminal's grants for its whole life. After a reboot, run sommus start once.
The laptop still has to be awake: closing the lid pauses everything until it's opened.
Permissions, once
sommus permissionsTriggers every macOS prompt in one go — Accessibility, Screen Recording, Contacts, Reminders, Chrome, Chrome's JavaScript setting, Messages — while you're at the keyboard to approve them. Worth running before relying on the background service, since a prompt that appears while you're away silently blocks whatever it was doing.
Talking to Sommus (voice)
sommus voice # always listening: say "Hey Sommus", then just talk. Return wakes it; typing works.
sommus voices # hear the voices and pick oneEverything audio stays on the Mac, and none of it costs anything:
Step | How |
Waking | Silero VAD cuts the mic into utterances (~1% of a CPU core); Whisper reads each one, and only one that starts or ends with "Sommus", "Hey Sommus", "What's up Sommus" or "Yo Sommus" wakes it. Nothing is kept or sent before that |
End of turn | Smart Turn v3 (Pipecat, open source, ~55 ms on the CPU) judges from the tone of voice whether a sentence is finished: yes at a 0.4 s pause, and a pause to think gets up to 1.6 s |
Conversation | Awake, everything said is a request — no wake phrase — until 30 s pass after a reply (90 s after a question), or "that's all". A small model checks that speech without the name was meant for Sommus, not someone else in the room |
Interrupting | macOS echo cancellation keeps the mic open while Sommus talks; its name cuts it off ("Sommus, stop", or "Sommus, what about tomorrow?"), anything else — its own echo, the room — is ignored |
Understanding | Whisper small.en on Apple silicon ( |
Speaking | Kokoro-82M on Apple silicon ( |
Voice ID | WeSpeaker ResNet34 (VoxCeleb, CC BY 4.0) on onnxruntime, 26 MB, ~0.1 s per sentence. |
Live mode (Gemini Live)
sommus live # say "Hey Sommus", then talk like on a call: interrupt it, change your mind mid-sentence
sommus voices --gemini # hear Gemini's voices; pick one in [live] voice, steer the accent with [live] styleGemini Live hears and speaks in one model, so replies start in under a second (0.75 s measured) and it stops the
moment you talk over it. It's free on an AI Studio key. Sommus still hears the wake word locally, runs every
tool under its own rules (quick ones directly, the rest through the Claude brain as ask_sommus), and takes
the PIN locally — the microphone stops going to Google until the digits are heard
(decision 10).
Every utterance is logged to data/voice.log (loudness, detector score, transcript, and what was done with it),
so when it misses something the log says which layer dropped it. Measurements behind these choices:
decision 9.
Only the transcribed text reaches the model, so voice works unchanged wherever the brain runs.
Replies play through the Mac's current output — AirPods included, even if they connect after Sommus starts.
Set the voice in config.toml ([voice] kokoro_voice, speed); engine = "say" switches to the built-in
macOS voice, which is also the automatic fallback if Kokoro can't load.
Connecting Gmail
Sommus talks to Gmail over IMAP and SMTP with an app password, not the Gmail API. Gmail's read scopes are "restricted", so a personal OAuth app can't leave Google's Testing mode without a security assessment — and tokens in Testing expire every 7 days. An app password never expires and needs no cloud project.
Turn on 2-Step Verification on the Google account (required for app passwords).
Go to myaccount.google.com/apppasswords, name it "Sommus", and copy the 16-character password.
Put both in
.env(gitignored):
GMAIL_ADDRESS=you@gmail.com
GMAIL_APP_PASSWORD=abcd efgh ijkl mnopsommus check verifies the login. Without it, email still works through the browser
(compose_email) and the Gmail tools just explain the setup.
Architecture
INTERFACES BRAIN NODES
┌──────────────┐ ┌──────────────────────┐ MCP ┌──────────────────┐
│ terminal │─ text ─► │ agent loop │ ───────► │ laptop (macOS) │
│ telegram │ ◄ events │ LLM API │ ───────► │ vault (notes) │
│ voice │ │ permission tiers │ ───────► │ gmail │
└──────────────┘ │ audit log + cost │ └──────────────────┘
└──────────────────────┘Interfaces only exchange text and events with the brain. Voice is a new interface, not a rewrite.
Nodes are MCP servers. Each device lists its tools; the brain routes calls. A new device is a new node.
The agent loop is hand-written on the Messages API (
src/sommus/brain/loop.py): streaming, adaptive thinking, prompt caching, refusal fallback, and a step limit.
Permission tiers
Sommus runs with full permission by default: it acts without asking. Every tool still declares a tier
through MCP annotations, and every call is logged with its tier, so the gate can be switched back on
([safety] ask_before_destructive = true) when riskier tools arrive — email, files, voice.
Tier | Full permission (default) |
| Examples |
read | runs | runs |
|
reversible | runs | runs |
|
destructive | runs | asks y/N first |
|
always_ask | asks every time | asks every time | unused today; for tools that should never run unattended |
blocked | never runs, hidden from the model | same | set per tool in |
A tool with no annotations counts as destructive.
run_shell exists after an experiment in going without it: with no shell tool, Sommus typed a command
into Terminal with type_text instead — same power, no output, no exit code, no log, and it reported
success for something that never ran. A real tool is the safer of the two. AppleScript still receives
user text through argv, never string formatting, and every call is logged.
Setup
Needs macOS, Python 3.12, and uv (brew install uv).
uv sync
cp .env.example .env # then paste your model API key into .env
uv run sommus check # verifies the key, nodes, and macOS permissions
uv run sommusTo run it from any folder, add a shell function (this is what sommus means elsewhere in this README).
--no-sync matters: without it uv re-checks dependencies over the network on every launch, and a
dropped connection stops Sommus from starting. Run uv sync yourself after changing dependencies.
echo 'sommus() { uv run --no-sync --quiet --project "'"$PWD"'" sommus "$@"; }' >> ~/.zshrcmacOS Accessibility permission (for media_control, press_keys and lock_screen): System Settings →
Privacy & Security → Accessibility → enable the terminal app you run Sommus from, then restart it.
Reminders, Messages and Spotify/Music prompt separately the first time they're used (Privacy & Security →
Automation). Screen Recording is needed for screenshot, and reading a Chrome tab's text needs
Chrome's View → Developer → Allow JavaScript from Apple Events (titles and URLs work without it).
In the chat: /tools, /cost, /new, /quit. Ctrl+C cancels a reply.
Test a tool directly, no AI or API key needed:
uv run sommus tool # list tools
uv run sommus tool set_volume level=20
uv run sommus tool notify title=Hi message="From Sommus"Use the laptop node from any MCP client
The node is a standard MCP server, so any MCP-capable app can use it without the brain. Point the client at:
command: .venv/bin/python
args: -m sommus.nodes.laptop.serverScoring it
evals/commands.toml holds the 20 commands Phase 1 has to handle. The runner replays each one in a
fresh conversation and checks which tools were called:
uv run sommus eval # read tools run for real, the rest are simulated
uv run sommus eval --only volume # just the commands mentioning "volume"
uv run sommus eval --live # really run every tool (it will sleep the laptop)Currently 46/46 on Sonnet 5 at low effort, ~$0.0095 per command. Target: never below 90%. Each run is saved to data/evals/ with the tools called, replies, latency and cost,
so model and effort changes can be compared.
Layout
src/sommus/
├── brain/ loop.py · nodes.py · permissions.py · prompt.py · store.py
├── interfaces/ cli.py
├── evals/ runner.py
└── nodes/laptop/ server.py (MCP tools) · macos.py (system) · apps.py (music, Shortcuts, Reminders) · files.py
evals/commands.toml the 20 commands Phase 1 must handle
tests/ agent loop + permission gate against a scripted fake model and a real in-process nodeDevelopment
uv run pytest
uv run ruff check src tests && uv run ruff format src testsEvery turn and tool call is logged to data/sommus.db (SQLite) with tokens and cost.
Available Tools
48 toolsappend_to_fileA
Add a line to the end of a text file, creating the file if needed.
Args:
path: Full path to the file.
text: The line to append.
Inputs: path (required), text (required).
clickA
Click somewhere on screen, using coordinates from the most recent screenshot.
Args:
x: Horizontal position in the screenshot.
y: Vertical position in the screenshot.
double: True for a double-click.
Inputs: x (required), y (required), double.
click_page_linkA
Click a link or button on a page by its visible text — works inside web apps like LEARN and Gmail.
Args:
tab: Tab number, window.tab, or text from its title or URL.
text: Visible text of the link or button, e.g. "MATH117-L3-F26-Fong".
Inputs: tab (required), text (required).
close_browser_tabsA
Close Chrome tabs. List them first, then pass the ones to close. Closed tabs come back with Cmd+Shift+T.
Args:
tabs: Each a window.tab number ("1.4") or text from a title or URL ("Netflix"). Prefer numbers.
Inputs: tabs (required).
compose_emailA
Open a pre-filled Gmail draft in the browser for Jashan to look over. To send, use send_email.
Args:
to: Recipient address.
subject: Subject line.
body: Message text.
Inputs: to (required), body (required), subject (required).
create_reminderA
Add a reminder in the Reminders app. Unlike a notification, this persists and syncs to the iPhone.
Args:
title: What to be reminded about.
due: Optional date and time as "2026-09-14 20:00". Omit for a reminder with no time.
list_name: Optional Reminders list; omitted means the default list.
Inputs: title (required), due, list_name.
download_urlA
Download a file straight to disk. Works for public URLs; pages behind a login don't.
Args:
url: Direct http(s) link to the file.
folder: Where to save it (default ~/Downloads).
filename: Optional name to save it as.
Inputs: url (required), folder, filename.
find_contactARead-only
Look up someone's phone number and email in Contacts. Use this before messaging or emailing a person.
Args:
name: All or part of the name, e.g. "Kuljot", "didi", "mom".
Inputs: name (required).
find_filesBRead-only
Search the Mac for files and folders by name (Spotlight).
Args:
query: Part of the file name, e.g. "ECE 150", "resume", "lab 2".
limit: How many results (default 10).
folder: Optional folder to search inside, e.g. "~/Documents".
Inputs: query (required), limit, folder.
focus_browser_tabA
Bring a Chrome tab to the front.
Args:
tab: Tab number, window.tab, or text from its title or URL.
Inputs: tab (required).
get_batteryARead-only
Get the MacBook's battery percentage, charging state, and time remaining.
Inputs: no named parameters.
get_brightnessARead-only
Get the built-in display's brightness as a percentage.
Inputs: no named parameters.
get_clipboardARead-only
Read what's currently on the clipboard.
Inputs: no named parameters.
get_now_playingARead-only
Get the track and artist currently playing in Spotify or Music.
Inputs: no named parameters.
get_volumeARead-only
Get the Mac's output volume (0-100) and whether sound is muted — also answers "is it loud".
Inputs: no named parameters.
get_wifiARead-only
Check whether Wi-Fi is on and which network the Mac is joined to.
Inputs: no named parameters.
list_appsARead-only
List the apps currently open (the ones shown in the Dock), which one is in front, and which can't be quit.
Inputs: no named parameters.
list_browser_tabsARead-only
List every open Chrome tab with its window.tab number, title and URL.
Inputs: no named parameters.
list_contactsARead-only
List everyone in the Contacts app with their numbers and emails.
Inputs: no named parameters.
list_embedded_filesARead-only
URLs of files embedded in a page (PDF viewers, iframes) — the real file behind a viewer.
LEARN shows PDFs inside a viewer, so saving the tab saves the wrapper page. Open the URL this
returns, then save that tab instead.
Args:
tab: Tab number, window.tab, or text from its title or URL.
Inputs: tab (required).
list_page_linksARead-only
List a page's links and buttons as "text -> url". Use this instead of guessing where to click.
Args:
tab: Tab number, window.tab, or text from its title or URL.
contains: Optional filter, e.g. "L3" or "download".
Inputs: tab (required), contains.
list_remindersBRead-only
List the user's unfinished reminders.
Args:
limit: How many to return (default 10).
Inputs: limit.
list_shortcutsARead-only
List the macOS Shortcuts available to run. Use this to find capabilities Sommus has no tool for.
Inputs: no named parameters.
lock_screenA
Lock the screen immediately. Apps keep running; unlocking needs the password or Touch ID.
Inputs: no named parameters.
media_controlA
Play, pause or skip whatever is playing (Spotify, Music, YouTube in a browser...).
Args:
action: "pause" and "play" do exactly that (use these when asked to pause, stop, play or resume);
"play_pause" toggles; "next" and "previous" skip tracks.
Inputs: action (required).
notifyA
Show a macOS notification banner right now. For a reminder at a later time, use create_reminder.
Args:
title: Short bold heading.
message: Body text.
Inputs: title (required), message (required).
open_appA
Open an app, or bring it to the front if it's already running.
Args:
name: The app's name as it appears in /Applications, e.g. "Spotify", "Google Chrome", "Notes".
Inputs: name (required).
open_fileB
Open a file or folder in its default app (Finder for folders, Preview for PDFs...).
Args:
path: Full path to the file or folder.
Inputs: path (required).
open_urlB
Open a web page in the default browser.
Args:
url: A full http:// or https:// URL.
Inputs: url (required).
press_keysA
Send a keyboard shortcut to an app — for actions with no dedicated tool.
Args:
combo: Keys joined by "+", e.g. "cmd+s", "cmd+shift+t", "cmd+w", "escape", "left".
app: App to bring to the front first, e.g. "Google Chrome". Recommended.
Inputs: combo (required), app.
quit_appADestructive
Quit a running app. The app may still ask to save unsaved work.
Args:
name: The app's name, e.g. "Spotify". Use list_apps first if unsure of the exact name.
Inputs: name (required).
read_browser_tabBRead-only
Read the visible text of a Chrome tab — the way to see what's on a page.
Args:
tab: Tab number ("3"), window.tab ("1.3"), or text from its title or URL ("MATH 115").
Inputs: tab (required).
read_fileBRead-only
Read a text file, or list a folder's contents. Long files are truncated.
Args:
path: Full path, e.g. "~/Documents/notes.md".
Inputs: path (required).
read_pdfARead-only
Read a PDF as text, scanned ones included — far cheaper than screenshotting page by page.
Args:
path: Path to the PDF, e.g. "~/Downloads/MATH117-L3-F26-Fong.pdf".
pages: Which pages, e.g. "1-5", "3", "2,4,7". Omit for the whole file.
ocr: Read scanned pages with OCR when they have no text layer (slower, ~3s a page).
Inputs: path (required), ocr, pages.
run_shellADestructive
Run a shell command and read its output. The way to do anything with no dedicated tool.
Commands run as Jashan from his home folder. sudo won't work — there's nobody to type a password.
Args:
command: The command line, e.g. "ls ~/Downloads", "git -C ~/x status", "brew list | head".
timeout: Seconds to allow before giving up (default 60).
Inputs: command (required), timeout.
run_shortcutA
Run one of the user's macOS Shortcuts. This covers things with no dedicated tool, such as Focus modes.
Args:
name: The shortcut's name — call list_shortcuts first if unsure.
Inputs: name (required).
save_browser_tabA
Save a browser tab's file to disk (Cmd+S) — the way to get a PDF that sits behind a login.
Follow with read_pdf to read what was saved.
Args:
tab: Tab number, window.tab, or text from its title or URL.
folder: Where to save (default ~/Downloads).
Inputs: tab (required), folder.
screenshotARead-only
Take a screenshot and look at it. Use this to see an app's state, then click what you see.
Click coordinates refer to this image.
Inputs: no named parameters.
send_messageADestructive
Send an iMessage. This reaches another person and can't be unsent.
Args:
to: Phone number or Apple ID — look it up with find_contact when given a name.
text: The message body.
Inputs: to (required), text (required).
set_brightnessA
Set the built-in display's brightness (external monitors aren't supported).
Args:
level: Brightness from 0 (darkest) to 100 (brightest).
Inputs: level (required).
set_clipboardC
Put text on the clipboard, ready to paste.
Args:
text: The text to copy.
Inputs: text (required).
set_muteA
Mute or unmute sound output without changing the volume level.
Args:
muted: True to mute, False to unmute.
Inputs: muted (required).
set_volumeA
Set the output volume and unmute.
Args:
level: Volume from 0 (silent) to 100 (maximum).
Inputs: level (required).
set_wifiADestructive
Turn Wi-Fi on or off. Turning it off cuts the internet, including Sommus's own connection.
Args:
on: True to turn Wi-Fi on, False to turn it off.
Inputs: on (required).
sleep_computerADestructive
Put the whole MacBook to sleep. Sommus stops responding until the lid is opened or a key is pressed.
Inputs: no named parameters.
sleep_displayA
Turn the display off. Apps and downloads keep running.
Inputs: no named parameters.
type_textA
Type text into an app — for writing into a document, a form, a chat box.
Keystrokes go to whatever is in front, so pass `app` (or focus it first) when the text is meant
for a particular one. Don't use this to run shell commands; use run_shell, which returns output.
Args:
text: The literal text to type.
press_return: True to press Return afterwards (submits the line).
app: App to bring to the front first, e.g. "Google Chrome", "Notes". Strongly recommended.
Inputs: text (required), app, press_return.
waitARead-only
Pause before the next step — for pages, apps or downloads that need a moment.
Args:
seconds: How long to wait, up to 10.
Inputs: seconds (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 48 tools
Most tools target a clearly distinct resource+action (battery, volume, brightness, wifi, clipboard, apps), and descriptions proactively disambiguate tricky pairs like notify vs create_reminder, sleep_display vs sleep_computer, and type_text vs run_shell. A few pairs remain close (click vs click_page_link, save_browser_tab vs download_url vs list_embedded_files, list_page_links vs read_browser_tab), but the guidance largely resolves them.
The set sticks mostly to a verbose verb_noun pattern (get_battery, set_volume, list_apps, create_reminder, read_browser_tab), which is highly predictable. Minor deviations exist: bare verbs (notify, click, wait, screenshot), one noun_verb (media_control), and slightly inconsistent qualifiers (page vs browser_tab for the same concept).
At 48 tools this is a very heavy surface, well beyond the 15-25 range that already feels crowded, even accounting for the broad macOS-automation domain spanning browser, files, system, media, contacts and messaging. Individual tools are mostly justified, but the sheer count raises selection cost and overlap risk.
Coverage is broad and self-aware, with escape hatches (run_shell, run_shortcut, press_keys) for anything lacking a dedicated tool, and files/reminders/system state reasonably covered. Gaps remain: compose_email references a nonexistent send_email, and reminders/contacts/messages lack full update-delete lifecycle coverage.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
EXZA Remote — AI Computer Commander Your computer. Your control. Securely connect your own macOS, Windows or Linux computer to compatible AI clients, including ChatGPT and Claude. EXZA Remote provides 59 MCP tools for authorized file management, terminal operations, system monitoring, desktop automation and email workflows. GETTING STARTED 1. Create an EXZA Remote account. 2. Install the official computer connection client. 3. Pair your device using a temporary six-digit PIN. 4. Approve the connection on your computer. 5. Connect your preferred MCP client using EXZA OAuth. MCP ENDPOINT https://remote.exza.de/mcp TRANSPORT Streamable HTTP with OAuth 2.0 KEY FEATURES • 59 MCP tool interfaces • Secure computer and file access • Terminal commands and background jobs • File search, reading and editing • System monitoring and desktop automation • macOS, Windows and Linux support • Owner-controlled permissions and approvals COMPLETE INSTALLATION & DOCUMENTATION Detailed setup instructions, terminal installation commands, all 59 tools, troubleshooting and security information: https://github.com/exzade/EXZA-Remote/blob/main/docs/GLAMA_OVERVIEW.md Official website: https://remote.exza.de EXZA Remote is an independent, OAuth-protected service. Computer access requires individual account authorization and device-owner approval.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables AI assistants to automate macOS through AppleScript and JXA by providing 44 tools for application management, window control, and UI interaction. It allows for comprehensive system control including screen capture, keyboard and mouse simulation, and system information retrieval.4415 npm1MIT
- FlicenseBqualityDmaintenanceExposes macOS system controls and Apple apps as structured tools for Claude, enabling control of volume, music, files, browser tabs, and more via natural language with configurable permissions and rate limiting.311-
- FlicenseBqualityDmaintenanceEnables macOS automation through 45 AppleScript-powered tools for system control, app management, calendar, reminders, notifications, clipboard, and task scheduling.45-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to automate macOS applications, manage files, control music, send messages, and more through AppleScript.29 npm1GPL 3.0