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, but the menus differ. Step-by-step, with the exact click path for each:

Penlog is listed in ChatGPT's plugin directory, so there you can skip the URL entirely. In Claude you add it as a custom connector, which does not need a directory listing.

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 account without Pro connects, but every tool call returns a text notice (isError: true) instead of data.
  • 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.