← Back to Pushany

🤖 Agents (ChatGPT, Claude)

Use ChatGPT or Claude to add items to your checklists, set reminders, search your notes and more.

For example, you can ask: “Add milk and eggs to my shopping list, and remind me about the eggs tomorrow at 6 pm”, “What do I have today?”, or “Find my notes about Kyoto”.

Connect an agent

You can find the connection URL in the app under Settings → Integrations → Agents. Tap it to copy.

Claude
  1. In Claude, go to Settings → Connectors and select “Add custom connector”.
  2. Enter a name (for example, Pushany) and the URL above, then add the connector.
  3. Press “Connect”. The Pushany approval screen opens in your browser.
ChatGPT
  1. In ChatGPT, go to Settings → Apps & Connectors → Advanced settings and turn on “Developer mode”.
  2. Go back to Apps & Connectors, press “Create”, enter the URL above, and select OAuth for authentication.
  3. After you create it, the Pushany approval screen opens in your browser.

Menu names and locations in ChatGPT and Claude may change with their updates.

Approval screen

What agents can do

Default (write only)Access to contents allowed
Add items to checklists (due date, notification, repeat, note, flag)✓✓
Create checklists, set or remove a reminder for a whole list✓✓
Read checklists, check off and edit items (including due dates and notifications)—✓
Organize checklists (name, color, icon, note, pin, sections, order, move items to another list, uncheck all)—✓
See what’s due today and soon—✓
Search notes, checklists and the tray—✓
Read, create, append to and edit notes (title, text, tags, pin)—✓
View the tray, send to it (notifies your devices), copy to notes—✓
Send files (to the tray or as note attachments) and read them (images and text files)—✓
List reminders, and set or remove them on notes and tray items—✓

Shared notes and lists are encrypted with the protection key, so agents can’t read them even with access to contents. However, if the owner or an admin turns on “Allow reading contents” under “Agents” on the sharing screen, agents can read and edit it like items you don’t share (Sharing). When it’s off, agents can add items to a shared list only if “Show name to agents” is on for it.

Locked notes aren’t shown to agents.

Agents can’t delete anything (including moving it to the trash), share, or change encryption or account settings. When an agent edits or appends to a note, the previous version is saved in the note’s history.

Encryption and privacy

Review and revoke access

In Settings → Integrations → Agents, you can review and change the following.

Access that hasn’t been used for 90 days expires automatically.

PC agent (trial)

Agents that run in a terminal on your PC, such as Claude Code, can read and write your notes and checklists with the pushany command. Encrypted data is decrypted on your PC, so plain text is never sent to the server. Shared notes and lists can be read too.

  1. In the app, go to Settings → Integrations → PC agent and press “Create API key”. A command and an API key are shown. The API key is shown only this once.
  2. Install Node.js 22 or later and pushany on your PC. pushany is in a trial and is not publicly distributed yet.
  3. Copy the command (pushany login …) and run it in a terminal. When asked for your API key, paste the API key you copied. The API key isn’t shown on screen and isn’t part of the command, so it doesn’t appear in your shell history.
  4. Run pushany pair. Another device shows an approval request. On that device, press “Approve on this device”, enter the code shown in the terminal, and press “Approve”. To use your recovery key instead, run pushany pair --recovery. The recovery key isn’t shown as you type.
  5. Ask your agent something like “Read pushany help and add milk to my shopping list”. If you use it often, mention it in CLAUDE.md or a similar file.

Troubleshooting

The approval screen says “This device doesn’t have your encryption key, so it can’t allow access”

The browser that opened the approval screen doesn’t have your encryption key. Connect again from the browser you usually use. Or open Pushany in that browser, get your encryption key by approving from another device or entering your recovery key, and then connect again.

The agent says it can’t find a list

The list may not be selected under lists shown by name. Check Settings → Integrations → Agents. If that agent has access to contents, it can see the names of all lists you don’t share. For a shared list, check that “Show name” or “Allow reading contents” is on under “Agents” on the sharing screen.

The agent stops after many requests in a row

Each connection is limited to 30 requests per minute. Wait a moment and try again.