# The Margin

A remote MCP server connecting AI assistants to your daily planner, family boards, budgets, and habits. Lets your agent read and update personal records.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: themarginapp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/themarginapp/the-margin
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/the-margin

## What it 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.

## Requirements
- Remote server: `https://mcp.themarginapp.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http the-margin https://mcp.themarginapp.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add the-margin --url https://mcp.themarginapp.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "the-margin": {
            "url": "https://mcp.themarginapp.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "the-margin": {
            "type": "http",
            "url": "https://mcp.themarginapp.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http the-margin https://mcp.themarginapp.com/mcp
```

## When to use it
- 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
- 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.

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44908
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22082
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9623
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2071

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md