Magpie

Integrations · MCP

Push documents into Magpie from your MCP client.

Connect your MCP client to Magpie. Say “push this to Magpie” and the document lands in your Inbox canvas, ready to read on any device where you’re signed in, even with no signal.

Tested with Claude Code and Claude Desktop. The Codex CLI and Cursor configs below follow the same spec but haven’t been tested with a real push yet. Not yet with chat apps that need OAuth.

Demo video coming soon

20 seconds: push a plan from the terminal, then read it on a phone in airplane mode.

What it does

Set up in three steps

  1. 1

    Create a token

    Open Magpie and sign in with your email (you get a one-time code, no password). Then go to Menu → Settings → MCP connections and choose Create token. Copy the mgp_… token: it’s shown only once. You can revoke it in the same place.

    Open Magpie
  2. 2

    Add Magpie to your client

    Claude Code: run this once, with your token in place of mgp_...

    claude mcp add --transport http magpie https://www.magpie.md/api/mcp --header "Authorization: Bearer mgp_..."

    Claude Desktop: add this to claude_desktop_config.json and restart Claude. It uses npx mcp-remote, so you need Node.js installed.

    {
      "mcpServers": {
        "magpie": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote", "https://www.magpie.md/api/mcp",
            "--header", "Authorization: Bearer ${MAGPIE_TOKEN}"
          ],
          "env": { "MAGPIE_TOKEN": "mgp_..." }
        }
      }
    }

    Codex CLI: keep the token in an environment variable and add the server once.

    export MAGPIE_TOKEN=mgp_...
    codex mcp add magpie --url https://www.magpie.md/api/mcp --bearer-token-env-var MAGPIE_TOKEN

    Cursor: add this to ~/.cursor/mcp.json.

    {
      "mcpServers": {
        "magpie": {
          "url": "https://www.magpie.md/api/mcp",
          "headers": { "Authorization": "Bearer mgp_..." }
        }
      }
    }

    Other clients: any MCP client that supports streamable HTTP and a custom Authorization header can use https://www.magpie.md/api/mcp.

  3. 3

    Ask it to push

    Try “push this plan to Magpie”. Then open Magpie on your phone and go to your Inbox canvas. To read it on the go, add Magpie to your home screen: Share → Add to Home Screen in Safari, or Install app in Chrome.

What it doesn’t do yet

Privacy: pushed documents are stored as plain text in your Magpie cloud, like any other unencrypted cloud canvas. Tokens are personal and revocable. Read the privacy policy.

Push it now, read it later.

Open Magpie