Quickstart

The fastest way to connect Penlog is as a one-click connector: add mcp.penlog.app in your MCP client, sign in with Apple, approve access. No tokens to copy. Connecting requires Penlog Pro.

Connect with one-click OAuth

  1. Open your MCP client's connector settings and choose to add a custom / remote connector.
  2. Enter the server URL: https://mcp.penlog.app
  3. When prompted to authenticate, you'll be taken to mcp.penlog.app to Sign in with Apple and approve access for your account.
  4. Approve — the connector is now linked to your Penlog account.

The connect URL and Apple sign-in are the same across hosts:

  • claude.ai — Settings → Connectors → Add custom connector.
  • ChatGPT — add a custom connector and paste the URL.
  • Claude Desktop — add the connector in settings.

Make your first query

Once connected, ask the agent something that exercises your journal. For example:

What did I write in Penlog this week, and what tasks are still open?

Behind the scenes the agent calls list_pages / search_pages and list_tasks. If you get a coherent answer about your recent pages, you're connected.

Bearer-token fallback

For CLI tools and self-hosted clients that can't run the interactive OAuth flow, mint a plg_live_ token in the app and configure your client manually — see Remote MCP clients.

Requirements & limits

  • Pro is required to connect an agent — an unentitled account gets a 402 before any tool runs.
  • Rate limits are 60 requests/minute and 1000 requests/hour per token.
  • What a connection can do depends on its scope — see the scope presets.