# intents-mcp

Turns the App Intents your Mac already declares into MCP tools for an agent, using Shortcuts and public APIs only.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 6
- Author: VladUZH
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/VladUZH/intents-mcp
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/intents-mcp

## What it does

Every app on macOS describes its Siri and Shortcuts actions in App Intents metadata. intents-mcp reads those files and tells you what is available: `intents-mcp census` counts the declared actions, `intents-mcp list --tier simple` narrows them to the ones that run in the background, take plain text, numbers, dates or choices, and return output. Whatever you pick gets wrapped in a signed Shortcut and served to the MCP client over stdio.

Install with `brew install VladUZH/tap/intents-mcp`. The build is prebuilt for Apple silicon; on Intel you compile from source and need Xcode. macOS 26 or later is required, along with the `shortcuts` command that ships with the system. On macOS 27 you want a current Homebrew, otherwise it falls back to a source build and asks for Xcode 27.

Setup is manual by design. `enable` opens each wrapper in Shortcuts and you click Add Shortcut once — there is no public way to add one without that click. The first run may trigger a permission prompt; pick Always Allow. It tends to reappear whenever data goes into another app, and it can come back after a wrapper upgrade, since an upgraded wrapper counts as a new shortcut. Reminders and Calendar read their result back through a shared helper, which needs its own Add Shortcut click; skip it and those tools still work but report "not verified". Nothing reaches the agent until you enable it, and actions whose names suggest deleting, sending, buying or sharing stay behind `--allow-risky`.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- add a reminder to Reminders from inside an agent session
- create a Calendar event with a specific start time
- see which app actions this Mac actually declares
- enable one app action and disable the rest
- confirm an item was really created instead of trusting a success flag

## Example prompts
- Create a calendar event for Thursday at 15:00 about the release.
- Show me which tools are currently enabled.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md