MCP server for Mac
An MCP server for your Mac
Edith ships an MCP server inside the app. Register it once with Claude Code, Codex, Cursor or VS Code, and the commands of every extension you enable become tools your agent can call, with the same safety rules as the command line.
What is MCP
One protocol, any agent.
MCP, the Model Context Protocol, is an open standard for connecting AI apps to tools. A server describes the tools it offers, and a client such as Claude Code decides when to call them.
Edith's server is ed mcp, the command line inside the app. Each command becomes one tool named after it: ed usage limits is edith_usage_limits and ed machines ls is edith_machines_ls. A tool takes an arguments array with exactly what the command accepts, and returns the same JSON as --json.
- Server name
edith- Command
/Applications/Edith.app/Contents/MacOS/ed- Arguments
mcp- Transport
stdio- Protocol versions
2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
Install
Add it to your client.
Every tab registers the same server. Use Edith's one-step installer, the client's own command, or edit the settings file.
One step with Edith
Adds an edith entry for Claude Code, backs up an existing settings file first and keeps every other server.
With the Claude Code command
Registers the same server through Claude Code itself.
Or edit the file yourself
Add this to ~/.claude.json. Edith adds a user-scope entry, so the tools are there in every project. Claude Code rewrites this file often, so prefer either command over editing it by hand.
{
"mcpServers": {
"edith": {
"args": [
"mcp"
],
"command": "/Applications/Edith.app/Contents/MacOS/ed",
"env": {},
"type": "stdio"
}
}
}Restart Claude Code, then ask it to call edith_catalog.
One step with Edith
Adds an edith entry for Codex, backs up an existing settings file first and keeps every other server.
With the Codex command
Registers the same server through Codex itself.
Or edit the file yourself
Add this to ~/.codex/config.toml. When CODEX_HOME is set, Edith edits config.toml in that folder instead.
[mcp_servers.edith]
command = "/Applications/Edith.app/Contents/MacOS/ed"
args = ["mcp"]Restart Codex, then ask it to call edith_catalog.
One step with Edith
Adds an edith entry for Cursor, backs up an existing settings file first and keeps every other server.
Or edit the file yourself
Add this to ~/.cursor/mcp.json. This is Cursor's global file, so the tools are there in every project. A project's own .cursor/mcp.json takes the same entry.
{
"mcpServers": {
"edith": {
"args": [
"mcp"
],
"command": "/Applications/Edith.app/Contents/MacOS/ed"
}
}
}Restart Cursor, then ask it to call edith_catalog.
One step with Edith
Adds an edith entry for VS Code, backs up an existing settings file first and keeps every other server.
Or edit the file yourself
Add this to ~/Library/Application Support/Code/User/mcp.json. VS Code uses a servers key rather than mcpServers. Run MCP: Open User Configuration from the Command Palette to open this file.
{
"servers": {
"edith": {
"args": [
"mcp"
],
"command": "/Applications/Edith.app/Contents/MacOS/ed",
"type": "stdio"
}
}
}Restart VS Code, then ask it to call edith_catalog.
Prefer buttons? Settings, then Tools, lists each client as Connected or Not connected, and Connect all registers every client it finds on this Mac. ed mcp status prints the same report.
Previews and confirm
Destructive changes wait for you.
A command that needs --yes on the command line returns a preview over MCP until the call passes confirm. An agent that forgets gets the preview, never the change.
- 1
Discover
The agent calls
edith_catalog. It lists every extension as enabled, installed or available, with its summary and example commands. - 2
Call
It calls the matching tool.
ed usage limits --refreshbecomesedith_usage_limitswith{"arguments": ["--refresh"]}. - 3
Install when needed
If the extension is only available, the agent asks you, then calls
edith_extensions_installwithconfirm. The server tells the client its tool list changed.
- A call that slips
--yesinto its arguments is refused. - Installing, updating, enabling, disabling and removing extensions follow the same rule.
agent edith_clipboard_clear {"arguments": ["--keep-pinned"]}
edith preview: the entry ids that would go, nothing removed
agent asks you, and you say yes
agent edith_clipboard_clear {"arguments": ["--keep-pinned"], "confirm": true}
edith applied: the same JSON as ed clipboard clear --jsonTools
Tool prefixes by extension.
Every command an extension adds becomes tools that start with its prefix. Open an extension to see its commands.
| Extension | Tools | What it does |
|---|---|---|
| Audio Mixer | edith_audio_* | Set the volume of each app separately. |
| Presenter | edith_presenter_* | Blur private details in Edith while you share your screen. |
| Color Picker | edith_color_* | Pick any color on your screen and copy it in the format you need. |
| Menu Bar Stats | edith_system_* | See how busy your Mac is, right in the menu bar. |
| Emoji Picker | edith_emoji_* | Find and type any emoji without leaving what you are writing. |
| Homebrew | edith_brew_* | Install, update and remove Homebrew packages without the terminal. |
| Calendar | edith_calendar_* | Your next meetings at a glance, with one-click join. |
| Jev | edith_jev_* | Faster, smarter decisions behind Edith's smart features. |
| Running Apps | edith_apps_* | See what is running and quit what you do not need. |
| Keyboard Clean | edith_keyboard_* | Lock the keyboard and clean your keys without typing anything. |
| Cleaner | edith_cleaner_* | Get back disk space from caches and leftovers, safely. |
| App Updates | edith_maintenance_* | Keep your apps current and remove them cleanly. |
| Plugins | edith_skills_* | Teach your coding agents how to use Edith with one-click skills. |
| Shelf | edith_shelf_* | A tray for files you are moving around, right under the notch. |
| Clipboard | edith_clipboard_* | Everything you copy, searchable and one shortcut away. |
| Music | edith_music_* | Your music in one place, with playback that never gets in your way. |
| Docs | edith_docs_* | Ask how to do something in Edith. |
| LaTeX | edith_latex_* | Write LaTeX documents and see the PDF next to your source. |
| Memory | edith_companion_* | A private memory of your notes and voice memos that you can ask questions. |
| Studio | edith_studio_* | Edit, compress and convert PDFs, images, video and audio on your Mac. |
| Usage | edith_usage_* | See what your coding agents cost and how close you are to their limits. |
| Launcher | edith_bifrost_* | Open apps, do quick math and find files from one bar. |
| Lid Awake | edith_lid_awake_* | Keep your Mac running with the lid closed. |
| Attention | edith_attention_* | See which apps and sites really get your time, and protect your focus. |
| Machines | edith_machines_* | Watch, browse and run your servers and containers from one place. |
| Downloads | edith_download_* | Save videos, audio, photos and posts from links to your Mac. |
| Site Audit | edith_seo_* | Find SEO problems on your website, page by page. |
| Virtual Camera | edith_camera_* | Look your best in every video call, with one camera that works everywhere. |
| Code Stats | edith_code_stats_* | See how much code you write, across every GitHub repository you own. |
| Agents | edith_herdr_* | See every coding agent on your Macs in one board, and step in when one needs you. |
| Code Review | edith_quinjet_* | Review GitHub pull requests and code changes in a focused terminal workspace. |
| Database | edith_database_* | Browse and safely edit your databases without leaving your Mac. |
Built into the server
edith_catalogEvery extension, its status, summary and examples.edith_extensions_*Install, update, enable, disable and remove extensions.edith_app_*Open pages, reveal settings and read app information.edith_config_*Read and change Edith settings.edith_permissions_*See and request the macOS permissions Edith uses.
While Jev is enabled with a TypeSafe key saved, the server also lists edith_find, which takes a plain-language request and returns the likeliest tools.
Examples
Ask in plain words.
Four prompts and the tools an agent calls to answer them.
“How much of my Claude limit is left, and what did I spend this week?”
edith_usage_limits {"arguments": ["--refresh"]}
edith_usage_summary {"arguments": ["--range", "week"]}Uses Usage.
“Merge intro.pdf, body.pdf and appendix.pdf into one PDF.”
edith_catalog {"query": "pdf"}
edith_extensions_install {"arguments": ["studio"], "confirm": true}
edith_studio_run {"arguments": ["pdf.merge", "intro.pdf", "body.pdf", "appendix.pdf"]}Uses Studio.
“Which containers are stopped on my build server?”
edith_machines_ls {}
edith_machines_docker_ps {"arguments": ["--all", "build-box"]}Uses Machines.
“Clear my clipboard history, but keep what I pinned.”
edith_clipboard_clear {"arguments": ["--keep-pinned"]}
edith_clipboard_clear {"arguments": ["--keep-pinned"], "confirm": true}Uses Clipboard.
Frequently asked questions
Where does the Edith MCP server run?
On your Mac. Your client starts /Applications/Edith.app/Contents/MacOS/ed mcp as a local process and talks to it over standard input and output. Each tool call runs the matching ed command and returns its JSON.
Do I need the ed command on my PATH?
No. Every registration points at the ed inside the app, so it keeps working whether or not you ran ed install. To run the installer without it, use the full path: /Applications/Edith.app/Contents/MacOS/ed mcp install --client all.
Which tools will my agent see?
Tools exist only for extensions you have enabled, plus the built-in ones such as edith_catalog. When you install or enable an extension, the server sends notifications/tools/list_changed so the client lists tools again.
Can an agent delete something without asking?
Not through a destructive command. Those return a preview, and the server adds --yes only when the call passes confirm: true. Other commands run as soon as they are called, so your client's own tool approval still applies to them.
Does it work with other MCP clients?
Any client that can start a stdio server can use it. Point it at /Applications/Edith.app/Contents/MacOS/ed with the single argument mcp.
How do I remove it?
Run ed mcp uninstall --client all, or a single client name, or press Disconnect in Settings, then Tools. Only the edith entry is removed.
Edith for your coding agent
- Claude Code on Mac: Usage, Limits and MCPSession, weekly and Fable limits in the menu bar, cost by repository, several Claude accounts, permission prompts you can answer from Edith, and every Edith command as an MCP tool.
- Codex on Mac: Usage Limits, Workspaces and MCPCodex's 5-hour and weekly limits in the menu bar, local and Codex Cloud history, a board that launches Codex with your model and effort, and every Edith command as an MCP tool.
- How to Add an MCP Server to Claude Code on MacAdd an MCP server to Claude Code on a Mac with claude mcp add, pick the right scope, check it with /mcp, and connect Edith's tools in one command.
- Coding Agent Tools for Mac: Claude, Codex, CursorUsage and limits, the Agents board, code review, skills and the ed command line in one place.
Updated
Get Edith.
From $35 once. No subscription. No account.
Needs a license key · macOS 14 or later on Apple silicon · 6.4 MB