The Margin — Claude Code MCP server: what it does, how to install
A remote MCP server connecting AI assistants to your daily planner, family boards, budgets, and habits. Lets your agent read and update personal records.
claude mcp add --transport http the-margin https://mcp.themarginapp.com/mcpWhat The Margin does
The server exposes workspace data over Streamable HTTP at https://mcp.themarginapp.com/mcp. Authentication relies on OAuth 2.1, meaning setup usually requires only passing the endpoint. Once linked, an assistant gains visibility into personal notes, chore boards, meals, and financial logs. Because the underlying app stores local copies, information stays intact offline and syncs back when your connection returns.
The catalog provides 271 tools. Among them, 112 perform read-only lookups, 82 handle record creation or updates, and 77 are capable of removing entries. Every operation remains bound to the logged-in user and their chosen workspaces. If you prefer evaluating actions without signing up, the sandbox endpoint at https://mcp.themarginapp.com/sandbox/mcp spins up an ephemeral household. That temporary space gets purged roughly an hour after your last call.
What it helps with
- inspect and complete daily habits via conversational commands
- log household expenses directly into your shared budget
- manage task boards and shopping checklists from the editor
- test agent workflows inside a throwaway sandbox without signing up
Example prompts for the agent
- Review my tasks for today in The Margin and mark morning exercise as done.
- Add 45 dollars for groceries to my weekly household spending.
- Check what meals are planned for dinner tonight.
How to install The Margin
Platform CLI: remote server
claude mcp add --transport http the-margin https://mcp.themarginapp.com/mcpPlatform CLI: remote server
codex mcp add the-margin --url https://mcp.themarginapp.com/mcpConfig file
{
"mcpServers": {
"the-margin": {
"url": "https://mcp.themarginapp.com/mcp"
}
}
}Config file
{
"servers": {
"the-margin": {
"type": "http",
"url": "https://mcp.themarginapp.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http the-margin https://mcp.themarginapp.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about The Margin
How do I install The Margin in Claude Code?
Run claude mcp add --transport http the-margin https://mcp.themarginapp.com/mcp. The client will guide you through standard OAuth 2.1 authentication in your browser.
What does The Margin MCP server do?
It gives your AI direct access to notes, checklists, budget logs, and meal plans. Assistants can retrieve data or record new events under your user profile.
Can I try The Margin without creating an account?
Yes, connect to https://mcp.themarginapp.com/sandbox/mcp. It generates an isolated demo environment that clears itself roughly an hour after your last interaction.
