The Margin
Notes, boards, habits, money and family life in one place your AI can read and act on.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http the-margin 'https://mcp.themarginapp.com/mcp'
{
"mcpServers": {
"the-margin": {
"type": "http",
"url": "https://mcp.themarginapp.com/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
The Margin
One place for work, home and your own plans, that works offline and that your AI can use.
Website · Try it, no account · Docs · Changelog · Discussions
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.
Made by Meliura Ltd
Frequently asked questions
What is The Margin?
Notes, boards, habits, money and family life in one place your AI can read and act on.
How do I install The Margin?
It runs as a remote server. In Claude Code: claude mcp add --transport http the-margin 'https://mcp.themarginapp.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does The Margin need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is The Margin open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains The Margin?
It is published by themarginapp. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.