PA Buddy Platform
Sign inGet started

Help · Your PA

Connect your PA: assistants, keys and the API

Your PA is the same wherever you talk to it: the PA tab in your planner, an assistant you already use (Claude, ChatGPT, Grok, Cursor…), a script or bot of your own, or a message on WhatsApp, Telegram or email. This page shows how to connect each one.

1. Make a key

In your planner open More → Your account → Assistant and API keys. Give the key a name (so you recognise it later), choose what it may do, press Create key, and copy it straight away — it is shown once and never again.

  • Talk to my PA (recommended) — the key can do everything the PA tab does: tell it things, send photos, ask questions, change or remove records, undo, and get files back. It cannot read or rewrite your raw records or files directly.
  • Everything — adds the raw records and files (the same access as the app itself). Only give this to something you run yourself.

You can make as many keys as you like, one per assistant or script, and revoke any of them on the same screen. A key can be set to expire after a number of days.

2. An assistant that speaks MCP (Claude, ChatGPT, Cursor and others)

Add My PA Buddy as a connector, with the key as the bearer token:

  • Address: http://localhost:3456/api/mcp
  • Header: Authorization: Bearer <your key>

Claude (desktop app or claude.ai): Settings → Connectors → Add custom connector → paste the address; when it asks for an authorization header or token, paste the key.

Claude Code: claude mcp add --transport http mypabuddy http://localhost:3456/api/mcp --header "Authorization: Bearer <your key>"

ChatGPT and others: look for "custom connector", "MCP server" or "tools" in the settings and paste the same address and header.

Then just talk. "Log a chicken wrap for lunch." "What's on tomorrow?" "Change that to a snack." "Show me Tuesday's receipt." "Undo." The assistant uses the pa_message tool, which is your PA — the same rules, the same filing, the same undo — and it can pass photos along with the words.

The other tools it may use: get_today and get_range (read your records, with ids), update_item and delete_item (change or remove one record by id), undo, get_file (a photo or file), export (CSV of meals, exercise, notes, tasks or meetings), drop_in_inbox and list_inbox (keep things to sort later), and the quick typed shortcuts log_meal, log_exercise, log_weight, log_water, log_sleep, add_note, add_task, add_meeting and search.

3. Your own script or bot (Grok, a Telegram bot you run, a phone shortcut)

Every request carries the key in a header: Authorization: Bearer <your key>. Replies are JSON.

  • POST /api/v1/pa — one turn with your PA. Send JSON {"text": "had a salad for lunch"}, or a multipart form with text and one or more file fields (photos, PDFs, voice notes). You get back the PA's reply, what it filed (each with an undo reference), any question it has, and links to files it returns. Add replyToBatch to answer a question about things it kept.
  • POST /api/v1/inbox — the same body shapes, but nothing is filed: it is kept for sorting later. GET /api/v1/inbox lists what is waiting.
  • GET /api/v1/day?date=YYYY-MM-DD — everything recorded that day, with ids, plus your day rules and open tasks.
  • GET /api/v1/range?from=YYYY-MM-DD&to=YYYY-MM-DD — the same for up to 92 days.
  • PATCH /api/v1/items — change one record: {"collection": "health", "docId": "2026-09-19", "itemId": "<meal id>", "patch": {"slot": "snack"}}. Fields you may change: meal text, slot, kcal, day, time; exercise type, minutes, km, notes, day; note text, mood; document title; task title, due, followUp, who, status, done; meeting title, date, start, end, mode, location.
  • DELETE /api/v1/items — the same body without a patch.
  • POST /api/v1/undo — put back the last change, or a specific one using the undo reference from an earlier reply.
  • GET /api/v1/files/<id> — a photo or file by id (ids appear on meals, notes and documents).
  • GET /api/v1/export?what=meals&from=…&to=…&format=csv — records as a file. what is meals, exercise, notes, tasks or meetings.

A quick try from a terminal: curl -X POST http://localhost:3456/api/v1/pa -H "Authorization: Bearer <your key>" -F text="lunch" -F file=@photo.jpg

With an Everything key the raw store is open too: /api/db/<collection>/<docId> (GET, PUT, PATCH, DELETE), /api/assets and /api/export. Most scripts never need it.

4. WhatsApp, Telegram or email

No key needed. Save your mobile number under More → Your account → Your details, then message the number your brand gives you. Text, photos, voice notes and documents all reach your PA, it files what it is sure about, asks about the rest, and replies in the same chat. Photos it sends back come as links that work for 24 hours.

Limits and good manners

Each plan has a daily allowance of assistant calls and photo analyses; when it is used up your PA keeps what you sent in your inbox and picks it up the next day. A key is limited to 120 requests a minute. Everything a key does is recorded in your PA chat, so you can see and undo it from the planner.

Still stuck? Contact us.