Connections

Connect the apps you use every day, like email, calendar and notes, and your agent can read what it needs and turn it into watches, library items and documents. Connections are in beta and more apps are on the way.

What it's for and how people use it: Connect apps on waper.ai.

Apps and skills are both in Settings (the Apps and Skills sections): apps give your agents more to reach, skills give them more they know how to do. Connect an app once and every agent can use it.

Read public X posts

Open Settings → Apps on web or desktop, or Me → Apps on iPhone. Search for X, Twitter or 推特 and select X · Built-in. It uses no connection slot and needs no account authorization. Select Use in chat to append an editable example to your draft, then send it when ready. Free users can view the details and upgrade. Paid users can also select @X in the composer.

On a paid plan, paste a public X link or ask your agent to search a topic, find recent posts by an account, check trends, or read a thread and its replies. For requests like “find posts mentioning me”, enter an optional X username on the X details page or in General settings or give the agent a handle for just that request. You can edit or clear the username at any time. It is an unverified search preference.

Open View steps to see which tools ran. Links to original posts identify the sources. Your agent flags excerpts, missing replies and unknown metrics. An ordinary empty search ends there. Ask to broaden the search for another pass. On-demand discovery and page reading can incur third-party costs that count toward the current request. Save a post to your library or ask for a draft and open X to review and send it yourself.

To keep following an account or topic, give the agent the public handle or keywords. Scheduled collection uses free sources and new posts can appear in your watch briefs.

Where to connect

  • Settings → Apps: select "Connect apps" at the bottom of the sidebar (or Connect apps in the + menu of the input box), or open Settings and choose Apps. At the top is a search box: search by app name or by what you want done (for example "meeting notes"). Below are a few cards on what a connection gets you and all apps, with the connected ones first and checked, and a + to connect the others. Open an app for its page (‹ Apps at the top left takes you back to the list): what it does for you, example prompts (select one to say that sentence in your chat), the access it needs and how data is handled.
  • In a chat: when you ask an agent for something that needs an app you haven't connected, it shows a connect card explaining what you'll get and what access it needs. Tap Connect, finish signing in, and you land back in the same chat: a message there says the app is connected and what was turned on for you (in a group chat, in that group), and the agent picks up where it left off, so you don't have to ask again. Not interested? Tap Not now (it won't suggest the app for a while) or Don't suggest again.

Connect an app

  1. Tap Connect in Settings → Apps or on a connect card;
  2. Sign in on the app's authorization page and approve access (for most apps the page may show our connection provider, Composio; Notion's shows Waper);
  3. You're sent back to Waper. The app's page shows which account is connected. What the app can do on its own is already turned on, and a message lists what was turned on: in the chat you connected from, or in Kiki's chat if you connected from Settings.

A few apps (such as Readwise) connect with an access token instead: paste the token in the dialog, which links to where you can find it. Tokens are stored encrypted and only used for what you turn on.

If authorization doesn't finish (you cancelled, or the link expired), Settings → Apps tells you why at the top. Just tap Connect again.

Finish authorizing in the same browser where you tapped Connect. If the authorization page opened in a different browser (or you finished more than about ten minutes later), Waper first shows a confirmation page with where and when the connection was started. Tick the box to confirm you started it yourself, then tap Connect; if it wasn't you, tap Cancel and the authorization is revoked.

Don't open an authorization link someone else sends you, and don't send yours to anyone. If you finish authorizing from a link someone else started, Waper doesn't connect your account to anyone: it revokes the authorization and tells you why.

After you connect

Each app's page shows:

  • What it can do for you: automatic features, such as merging the newsletters in your inbox into one daily brief. They're turned on when you connect and run on their own at set times; turn off any you don't need. Anything you turned off stays off if you connect the app again later.
  • What it can access: what your agent may read or do in that app.
  • Account: the connected account, when it was last used, and today's actions.
  • Your instructions: how you want your agent to work in this app, such as "put new pages in the Work database". It follows them every time it uses the app. Say "from now on, in Notion, always…" in a chat and your agent adds it here and tells you which line it added; clear it to stop.

You can also ask your agent to use the app for anything else in a chat, for example "any important email today?"

Something happening in an app can also start a routine you wrote yourself: a new email in Gmail or Outlook, a Google Calendar event about to start, a review request or mention on GitHub, a Notion page being edited. When creating one, choose "Trigger", then pick the app.

What each app does

App What you get Access
Gmail A daily newsletter brief; a summary and to-dos as soon as mail Gmail marks as important arrives (or ask your agent to watch only certain people) Read mail, attachments and labels; draft and send emails, reply, send drafts, organize labels and move individual messages to trash; requests to draft leave the email unsent
Google Calendar A brief the evening (and morning) before meeting outside people Read events; create or edit events on your own calendar; inviting people, responding to invitations and deleting follow the rules below
Notion Choose "Export to Notion" in a document's ⋯ menu — it's created under the most recently edited page you've shared with Waper (you'll be asked to share one first if there is none); pages shared with Waper land in your library Search and read the pages and databases you authorize, query databases; create pages under a page or rows in a database, append content, edit properties; read and add comments; moving to trash follows the rules below, and pages can be restored from trash
Readwise Kindle and Reader highlights land in your library daily; save articles to Reader Read highlights and Reader documents, save articles; never deletes
Slack Key points and to-dos from your channels every evening (no DMs; ask your agent to follow only some channels), optionally sent to you as a DM Search and read messages you can see; posts messages or thread replies only when you ask, and asks each time before messaging someone new
Outlook Newsletter brief, important mail and meeting briefs (same as Gmail and Google Calendar; work accounts may need an admin's approval) Read mail and events, search people, draft, send, reply, send drafts, organize and move mail; create, change and delete events on your own calendar and respond to invitations; requests to draft leave the email unsent
Granola Meeting notes and summaries land in your library Read-only
GitHub A daily developer brief (releases, issues and PRs, with review requests called out); Kiki suggests in its chat turning starred repos into release watches Read-only, including PR files, repository content and commit history; GitHub's consent page lists broader permissions, but Waper never writes or comments
Google Drive Recently edited Google Docs, Sheets, Slides, PDFs and text files in your own Drive land in your library with their text (the last 90 days when you connect, then new edits each day); Word files bring their file info only; export briefs and documents as Google Docs Read file info and text; create files and folders; never shares or deletes

Pages Waper creates or edits in Notion show Waper as the creator and last editor. Slack is connected through an app provided by Composio, and its authorization page shows Composio; messages your agent posts in Slack appear under your own name. YouTube is not open to new connections for now; if you are already connected, you can still see it and disconnect it in Settings → Apps, its automations have stopped, and your agents no longer use it. Settings → Apps shows when each app is available.

Where results go

  • Digests (newsletters, channel key points, developer brief): posted in full in Kiki's chat. To keep them as documents too, just tell your agent (for example "save my newsletter brief as a document from now on"), and each one is also saved in "My knowledge base";
  • Important mail: a message in Kiki's chat that opens the original email;
  • Meeting briefs: run as deep research in the background and saved as a sourced document in "My knowledge base"; the daily number depends on your plan (Free 1, Personal 3, Pro 10), each meeting is prepared once, and again if its time or attendees change;
  • Library imports: searchable and askable in your library; video transcripts and summaries appear when ready;
  • Suggested watches (GitHub stars): a suggestion in Kiki's chat you can accept; the watch it creates is private;
  • Exports: a message in the chat that opens the page in Notion or Google Docs.

When an automatic feature runs into trouble, the app's page says which kind under that feature: the connection stopped working and the feature is paused (it resumes once you reconnect); it failed several times in a row and was turned off (turn it back on to try again; the app being busy or briefly down doesn't count); the last run didn't go through and will be retried; or the last run finished but part of it didn't go through (for example a message that wasn't delivered).

If a page fails during automatic collection, the items already fetched are still processed, and the next run resumes from the previous position. This also applies to the first sync: its starting point is kept even if the retry happens on a later day. Ordinary library links are not limited to the first 100 items; audio and video that need a paid transcription are limited to 100 items per run.

When your agent asks first

Apps follow the same rules as everything else (in full under When it asks first):

  • Reading content and saving to your library happen right away and are recorded.
  • Writing in an app (a draft, a calendar event, a to-do) is done directly and it says what it did; to take back one that can be undone, tell it within 24 hours and it undoes it. Deleting something that can't be undone (such as removing something in the app) goes ahead when you named it and it matches only one thing; otherwise it asks you first.
  • Sending in your name (email, messages, posts) first shows a card with the full text, the recipients and the account it goes from; tap once to send. To trusted recipients, or when you said "send it directly, no need to show me", it goes out directly, and sending to your own mailbox goes out directly. Sending a Gmail or Outlook draft, an Outlook reply or reply-all, a meeting response, changing or deleting an Outlook event, and a Google Calendar update that notifies other people still ask first, because the full recipient list can't be worked out from the call.
  • Once a turn has read outside content (briefs, library items, email bodies, web pages) it is more careful: a write that can't be undone and a send to a trusted recipient first go through an automatic safety check, so instructions hidden in outside content can't decide for you; sending to someone you have never mentioned always asks.
  • Changing permissions or settings and payments are not available.

How your data is handled

  • Except Notion and Readwise, apps connect through Composio (our subprocessor, which keeps the parameters and results of calls for up to a year). Waper connects to Notion and Readwise directly, without Composio: the tokens from authorization (or the token you paste) are stored encrypted by Waper and used only for what you and your agents ask for; the call log is kept for 30 days and records only the app, the operation and whether it worked, not what was read or written.
  • Disconnecting revokes access with the app where it supports that and deletes the stored tokens; for apps that sync or import content you can choose to delete what was synced from it.
  • Content read from apps you connect is never used to train or improve models.
  • What your agent reads from an app in a conversation stays in that conversation and is deleted with it.
  • When you connect Gmail or Outlook, your newest 100 emails and new ones after that (except spam and deleted mail) are kept with their text, as are older emails your agent has read, so your agent can search and read them; attachments are fetched only when needed. Kept email is deleted a year after it was stored; if you delete an email from the last 7 days in your mailbox, it is removed here at the next sync.
  • Events that start a routine (a new email, say, with its text) are kept for 30 days.
  • Videos you have Waper transcribe keep their transcript and summary in your library.
  • Pages, highlights and meeting notes imported from Notion, Readwise and Granola are kept in your library with their text, and update on the next import when the source changes; Granola transcripts are not imported.
  • Recently edited documents, spreadsheets, presentations and PDFs in Google Drive are kept in your library with their text (files over 20 MB keep their file info only); your agent reads older files when it needs them, and pasting a file's link in your library or a chat adds it too.
  • All of this is visible only to you.
  • Content from emails and messages is treated as material only; instructions inside it are never followed.

Allowance

Personal and Pro let you connect every app you use and let your agent and automatic features use them far more often. Free lets you connect 5 apps to try it out.

Plan Connections Actions a day
Free 5 50
Personal Unlimited 2,000
Pro Unlimited Unlimited

An action is one read or operation your agent or an automatic feature performs in an app; fetching the text of imported items doesn't count. During the beta, actions don't use credits. You can see your usage under the app list in Settings → Apps and in each app's Account section.

Writing briefs and meeting briefs use credits for what they actually cost; transcribing videos is charged by the minute (see "Pricing" in Notetaker).

Disconnect

Tap Disconnect on the app's page. Your agent loses access right away, the authorization on the app's side is revoked, and automatic features using the app stop. If a connection stops working (for example you revoked access in the app), Kiki reminds you in its chat to reconnect.

Disconnecting also removes the app's triggers and turns off every automatic feature you set up with it; generated documents stay too, delete them if you don't need them. For apps that import content, you can tick "Also delete what was synced from" the app when disconnecting: imported items go to the trash, where you can still restore them. You can also revoke access from the app's own "connected apps" page.

The app you want isn't there yet

Search for it in Settings → Apps. Apps we haven't added yet appear under Not available yet; tap Want this to vote, or submit the name you searched for. If you ask an agent in a chat to use an app we haven't added, it tells you so and records your vote. We add the most requested apps next.