the-margin
MCP serverDocs & knowledgeNotes, boards, habits, money and family life in one place your AI can read and act on.
Available today. Use it from your connected AI after setup.
No other account needed.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the-margin
Install the-margin
The server’s own address, for the clients that take one directly. Or connect ahel once and every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.
Claude Code
claude mcp add --transport http --scope user the-margin 'https://mcp.themarginapp.com/mcp'Run it once in your project, then open /mcp to approve any sign-in the server asks for.
Claude Desktop
https://mcp.themarginapp.com/mcpAdd a custom connector in Settings, paste this address, and approve the sign-in.
Cursor
cursor://anysphere.cursor-deeplink/mcp/install?name=the-margin&config=eyJ1cmwiOiJodHRwczovL21jcC50aGVtYXJnaW5hcHAuY29tL21jcCJ9Open the link and Cursor adds the server at that address.
ChatGPT
https://mcp.themarginapp.com/mcpIn Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.
Codex
codex mcp add the-margin --url 'https://mcp.themarginapp.com/mcp'Run it once, then sign in with codex mcp login the-margin if the server asks for an account.
From the project's README
As published by themarginapp/the-margin in README.md.
What it is
The Margin keeps boards, notes, checklists, habits, money, meals, chores and chat in one app. A household or a team shares what it wants to share, and each person keeps a private side.
- It works with no signal. A full copy of your data lives on the device and catches up when it is back online.
- It has an assistant built in. Margin Intelligence can read across everything you keep there and act on it.
- It works with the assistant you already use. Claude, ChatGPT, Grok, Cursor and any other MCP client can connect to your workspace, and each thing they add is marked with who added it.
- Your data is yours. Export all of it whenever you like.
It runs in the browser and installs to a phone's home screen. Native apps for iPhone and Android are coming soon.
Connect your AI
The server is at https://mcp.themarginapp.com/mcp and speaks MCP over Streamable HTTP. Sign-in is OAuth 2.1, so most clients only need the URL.
| Client | How |
|---|---|
| Claude | Settings → Connectors → Add custom connector, paste the URL |
| ChatGPT | Settings → Apps & Connectors → Create, paste the URL |
| Grok | Settings → Connectors → Add custom, paste the URL |
| Claude Code | claude mcp add --transport http margin https://mcp.themarginapp.com/mcp |
| Cursor and other JSON-config clients | See connector/examples |
Menu names move around between releases of each client. If one of these is out of date, tell us.
Try it without an account
Point a client at https://mcp.themarginapp.com/sandbox/mcp with no credential. The server makes a demo household for that connection and deletes it about an hour after your last call.
claude mcp add --transport http margin-sandbox https://mcp.themarginapp.com/sandbox/mcp
What an assistant can do
271 tools. 112 only read, 82 add or change, 77 can remove or overwrite. Every one is scoped to the person who signed in and the workspaces they chose.
The full list is in connector/TOOLS.md, with input schemas in connector/tools.json. The guide is at themarginapp.com/docs/agents-and-mcp.
Report a problem or ask for something
- Something is broken: open a bug report.
- You want something added: open a feature request.
- A question, or something to show: Discussions.
- A security problem: please do not open an issue. See SECURITY.md.
- Your account or billing: email hello@themarginapp.com. Please keep personal details out of public issues.
What is in this repository
| Path | What |
|---|---|
server.json | The MCP Registry entry |
connector/ | The tool catalog, client configs and example prompts |
ROADMAP.md | What we are working on next |
| Issues and Discussions | Where bugs, requests and questions go |
The Margin's application code is not open source and is not in this repository. The files here are MIT licensed so you can copy the configs and examples freely.
Advanced
- Delivery
- the-margin MCP server → your ahel connector (mcp.ahel.ai) → your AI.
- Item type
- mcp-server
- Key
com-themarginapp-the-margin- Source
- github.com/themarginapp/the-margin
- Hosted endpoint
https://mcp.themarginapp.com/mcp