Skip to content
Moonjar Help

Connect Moonjar to Claude

Moonjar exposes a Model Context Protocol (MCP) server. Connect it to a Claude client and you can ask Claude things like “find that receipt from Tokyo” or “capture this article into my Moonjar” — the answer comes from your own Moonjar data.

What you can do once connected

Section titled “What you can do once connected”

Read scope:

  • Search and list your documents, conversations, memories, collections, trips, bookings, and reminders.
  • Pull a specific document, conversation, or trip itinerary back into the Claude window.

Write scope:

  • Capture a URL or a free-form note.
  • Add an item to a collection.
  • Create, update, or complete a reminder.

Memory writes and schema changes are intentionally not exposed — see What gets shared below.

Before you start

Section titled “Before you start”
  • A Moonjar account (sign up →).
  • One of: Claude.ai (workspace owner), Claude Desktop, Claude Code, or any MCP-compatible client that supports OAuth 2.1 with Dynamic Client Registration.

Connect

Section titled “Connect”
  1. Open your Claude.ai workspace settings.
  2. Add a new MCP connection at https://www.moonjar.io/mcp. [TODO: SCREENSHOT — Claude.ai add MCP dialog]
  3. You’ll be sent to Moonjar to sign in. Use your Moonjar email and your sign-in code.
  4. Approve the Read and Write scopes (or just Read if you prefer).
  5. You’re back in Claude.ai. The new tools are available in any chat.

How the handshake works

Section titled “How the handshake works”
sequenceDiagram participant C as Claude client participant M as Moonjar participant U as You C->>M: Register (Dynamic Client Registration) M—>>C: Client credentials C->>U: Open Moonjar login U->>M: Sign in, approve scopes M—>>C: Authorization code C->>M: Exchange code for tokens (PKCE) M—>>C: Access + refresh tokens C->>M: Tool calls (with token)

Access tokens last 1 hour. Claude refreshes them quietly using the refresh token (which lasts 30 days) until you revoke access.

What gets shared

Section titled “What gets shared”

When you approve Read, Claude can:

  • Search and list everything you’ve captured into Moonjar.
  • Pull back specific items by id — a document, a conversation summary, a trip itinerary.

When you approve Write, Claude can additionally:

  • Capture a URL or a free-form note.
  • Add items to your collections.
  • Create or complete reminders.

Claude cannot:

  • Edit memories.
  • Delete documents.
  • Change collection schemas.
  • See your password or account-level API key.

The token Claude holds is bound to your account and your data. Two Claude clients connected from two different machines both see your same library — there’s no per-client carve-out.

Disconnect or revoke

Section titled “Disconnect or revoke”

See Manage connected clients. The TL;DR: revoke a client from Moonjar settings, or remove the connector from Claude. Either side cuts access; revoking from Moonjar is the authoritative path because the token stops working on the next request.

Troubleshooting

Section titled “Troubleshooting”

Sign-in loops. Clear the OAuth cookie in your browser (the short-lived cookie scoped to /oauth) and retry.

Tool calls return “unauthorized”. Your token expired and the client hasn’t refreshed yet. Wait a few seconds and retry.

Don’t see your data. Confirm you signed in to the same Moonjar account you capture into. The connection is per-account.

See also

Section titled “See also”