ericblue

ericblue / mac-agent-gateway

Public

A local macOS HTTP API gateway that exposes Apple apps (Reminders, Messages, etc.) to AI agents

62
5
100% credibility
Found Feb 03, 2026 at 15 stars 4x -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Mac Agent Gateway provides a local macOS service enabling AI agents to securely access and interact with Apple Reminders and Messages apps.

How It Works

1
🖥️ Discover a Mac helper

While chatting with your AI assistant on your Mac, you learn about a simple tool that lets it reach your reminders and messages safely.

2
📥 Set up on your Mac

You download the tool and follow easy steps to install it right on your computer.

3
🔓 Grant quick permissions

Your Mac asks once to let the tool see your reminders and messages, and you say yes.

4
🚀 Start the helper

With one command, you launch the helper, and it's ready on your local machine.

5
🤖 Connect your AI

You share the helper's address with your AI so it can use your Mac's features.

6
💬 Chat and get help

Now you tell your AI things like 'add a reminder for tomorrow' or 'find that link from Jane', and it works perfectly.

✅ Daily tasks made easy

Your AI now manages reminders, sends texts, and finds info from your messages, all safely from your Mac.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 62 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mac-agent-gateway?

Mac Agent Gateway is a Python FastAPI server running locally on macOS that turns Apple apps like Reminders and Messages into a stable REST API for AI agents. It bypasses TCC permission walls and sandbox limits, so agents in VMs or containers can create reminders, send iMessages, search threads, or download attachments without direct CLI hacks. You get endpoints like /v1/reminders for CRUD and /v1/messages/send, all secured with API keys and running on localhost:8123.

Why is it gaining traction?

It stands out by keeping everything on-device—no cloud leaks for sensitive Messages data—while offering agent-ready skills for tools like OpenClaw or Claude Code, plus PII filtering, rate limiting, and SSH tunneling for remote access. Developers dig the granular controls like send allowlists and capability toggles, making it a secure bridge for local LLM Mac workflows or macOS local AI agents that need real app integration. With OpenAPI docs at /docs, it's plug-and-play for HTTP-calling agents.

Who should use this?

Mac users building local AI agents for personal automation, like devs scripting "text me overdue reminders" via a local GitHub Copilot alternative or OpenClaw setup. Ideal for those handling macOS local network permissions in VMs, wanting agents to manage Reminders lists or extract links from Messages without granting broad TCC access. Skip if you're not on macOS or need non-Apple apps.

Verdict

Solid early bet for Mac agent builders—install with make install, grant permissions once, and your local LLMs gain Apple superpowers. At 39 stars and 1.0% credibility, it's v0.3 immature but docs and tests are pro-level; productionize with launchd service for always-on reliability.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.