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:

Neither one requires Penlog to be listed in that client's connector directory. You are pointing the client straight at our server.

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.