the-margin

MCP serverDocs & knowledge

Notes, 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.

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/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=the-margin&config=eyJ1cmwiOiJodHRwczovL21jcC50aGVtYXJnaW5hcHAuY29tL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.themarginapp.com/mcp

    In 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.

ClientHow
ClaudeSettings → Connectors → Add custom connector, paste the URL
ChatGPTSettings → Apps & Connectors → Create, paste the URL
GrokSettings → Connectors → Add custom, paste the URL
Claude Codeclaude mcp add --transport http margin https://mcp.themarginapp.com/mcp
Cursor and other JSON-config clientsSee 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

What is in this repository

PathWhat
server.jsonThe MCP Registry entry
connector/The tool catalog, client configs and example prompts
ROADMAP.mdWhat we are working on next
Issues and DiscussionsWhere 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