The Margin

com.themarginappv1.0.0Updated Oct 1, 2026

Notes, boards, habits, money and family life in one place your AI can read and act on.

VerifiedStreamable HTTPWeb executableFinanceProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Connects an AI assistant to a Margin workspace so it can read and act on notes, boards, habits, money and family data.

What it does
The Margin is a personal and household app holding boards, notes, checklists, habits, money, meals, chores and chat. Its remote MCP server exposes 271 tools: 112 read-only, 82 that add or change data, and 77 that can remove or overwrite. Every tool is scoped to the signed-in person and the workspaces they choose, and items added by an assistant are marked with who added them.
When to use it
Use it when you already keep plans, lists, habits or household finances in The Margin and want an assistant such as Claude, ChatGPT, Grok or Cursor to read across that data or make changes on your behalf. A sandbox endpoint lets you try it without an account.
Requirements
A remote MCP endpoint over Streamable HTTP; no local package or runtime. Sign-in is OAuth 2.1, so most clients only need the server URL. A Margin account and workspace are needed for real data; the sandbox endpoint needs no credential and creates a temporary demo household deleted about an hour after the last call.
Before you install
The server can change and delete data: 82 tools add or change and 77 can remove or overwrite, so review what an assistant is allowed to do. Access is scoped to the signed-in person and chosen workspaces. The sandbox demo household is temporary and deleted about an hour after the last call, so do not rely on it for anything you want to keep.

Installation

In SourceWeft

  1. Open The Margin in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "the-margin": {
      "type": "http",
      "url": "https://mcp.themarginapp.com/mcp"
    }
  }
}

README

[The Margin]

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

[The Margin's daybook: today's tasks, notes and plans on one page]

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.

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

Made by Meliura Ltd

Source: README.md at commit c6ad541

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 1, 2026