Connecting your apps

• “Your connections” (in the Mac or Windows app, “Connections” at the foot of the sidebar; in a browser, Settings, then “Connections”) — your own: the Claude apps signed in as you, and the apps you let Nirvaana into. Only you see them.
• A world's connectors, in its “Settings” tab under “Connectors” — what feeds that world, such as a GitHub repo. Everyone in the world can see what feeds it, and each card says who can change it.

Nothing from your own connections is ever shown on a world's page.

Every connector is on the one page: the ones most people use come first, the rest follow, and what is still to come is last, marked “Coming soon”. Each card has the app's logo where the company allows it, and a simple drawing of what it is for (an envelope for mail, a calendar, a chat bubble) where it doesn't.

1. Press “Connect” on the app's card. In the Mac or Windows app, your browser opens for this part.Open your connections
2. Say yes on the app's own page. You come back to Nirvaana, connected.

The names and logos belong to their companies, and showing them doesn't mean a company endorses Nirvaana; a line at the foot of the page says so.

If you're 13 to 17, you can connect Google Calendar, Gmail, Google Workspace, Microsoft 365, Notion, Linear, Figma and Canva, and a GitHub repo to a world you own. Nirvaana reads them, and changes only your own things there, each on your Approve; it can also write an email draft you send yourself, or a comment on GitHub. Slack, Meta, Power BI and money connections aren't available.

Now and then an app's sign-in runs out, or is about to, and can't renew itself. Where you see it, a card in your day says so, such as “Google Calendar needs you to reconnect”, and the app's card says it needs you. Press “Reconnect” and say yes again. Until you do, Nirvaana stops reading that app; nothing it kept is lost.

Add Nirvaana to Claude once, and Claude on the web, the desktop app, your phone and Cowork can read your world as you, keep what you tell it, and ask for your yes before anything goes to a world.

1. In Claude, open Settings, then the Connectors settings, and add a custom connector called Nirvaana.
2. Paste Nirvaana's address, press connect, sign in to Nirvaana, and press Allow.
3. Turn Nirvaana on for your chat, and ask it what is due.

Connect Claude has the address and the steps for each Claude app, and how to check it worked. For Claude in your terminal, see Nirvaana in Claude Code. Each one shows in “Your connections”, where “Disconnect” signs it out.

1. Open “Your connections”, and under Google Workspace, where you see it, press “Connect Google Calendar”.Connect Google Calendar
2. Choose your Google account and say yes on Google's page. You come back to Nirvaana, connected.

It sees the events on your Google Calendar, up to two weeks at a time. It adds an event to it, only after your yes, one event at a time. Your events then show on your calendar, marked as Google's.

Where it is switched on, it can also invite people to an event (Google emails each one an invitation), and move or cancel an event you organize (Google tells its guests). Each is a card under “Before it goes out” that names every guest and says exactly what changes, and nothing happens until you press “Approve”. Events someone else organizes are never moved or cancelled, and an email or a page it has read in the same message can never start one.

More than one Google Calendar? Once one is connected, press “Add another account” on the Google Calendar card and choose the other account on Google's page. Each account is its own row, with its own Reconnect and Disconnect, up to five. Each card under “Before it goes out” names the calendar it goes on. With more than one, the card says: “Your calendar shows every account's events and says which each is on. A new event goes on the one you name, otherwise on your first one here.”

Where you see “Connect Gmail” on Your connections, press it, choose your Google account and say yes on Google's page. It sees your email when you or one of your own automations asks: a search, and the message it opens (receipts, invoices, bills). It puts a draft in your Gmail Drafts for you to read and send from Gmail yourself; it never sends anything.

More than one Gmail? Once one is connected, press “Add another account” on the Gmail card and choose the other account on Google's page. Each account is its own row, with its own Reconnect and Disconnect, up to five. With more than one, the card says: “A search reads every account here and says which each email came from. A reply is drafted in the account its email came to; a new email, in the one you name.”

1. Open “Your connections”, and under Google Workspace, where you see it, press “Connect Google Workspace (Google Drive, Docs, Sheets, Slides)”, then say yes on Google's page.Connect Google Workspace (Google Drive, Docs, Sheets, Slides)
2. Press “Choose files” and pick the docs, sheets and slides Nirvaana may read in Google's own file picker. Pick more any time the same way.

It sees the Google Docs, Sheets and Slides you pick for it, when you ask: a doc's words, a sheet's first rows, each slide's words, and only those files, never the rest of your Drive. Ask about one in your own chat. It makes a new Google Doc or Sheet from a draft you wrote together; it never changes a file you already have, only after your yes on a card.

More than one Google Workspace account? Once one is connected, press “Add another account” on its card and choose the other account on Google's page. Each account is its own row, with its own “Choose files”, Reconnect and Disconnect, up to five. With more than one, the card says: “A search looks in every account here and says which each file is in. A new file goes in the Drive you name, otherwise your first one here. Choose files for each account on its own row.”

Where you see “Connect Canva” on Your connections, press it and say yes on Canva's page. It sees the names of your recent Canva designs, and it starts a new design in your Canva from a page Nirvaana made with you, for you to finish there. Nothing is published or shared from your Canva.

Where you see “Connect Figma” on Your connections, press it and say yes on Figma's page. It sees a Figma file when you link it: its pages, frames and words, its comments, and a frame as a picture in the chat. It posts a comment you approved on that file, where everyone who can open the file sees it, only after your yes. It reads your files in your own chat, never in a world, and it can't make or change a design.

You can also connect Figma's own MCP in Claude next to Nirvaana.

Where you see “Connect Linear” on Your connections, press it and say yes on Linear's page. It sees your Linear issues, projects and teams, when you ask. It files or changes an issue, or comments on one, only after you press “Approve” on a card, one at a time, and the card then links to it in Linear. It never deletes anything. Ask for an issue in a chat and, if Linear isn't connected yet, a “Connect Linear” button shows under the reply.

Where you see “Connect Notion pages” on Your connections, press it and choose the pages on Notion's screen. It sees the Notion pages and databases you share with it, when you ask. It makes or changes a page, or comments on one, only after your yes on a card. It is its own connection, apart from the Notion that keeps your calendar: connecting or disconnecting one never changes the other.

Where you see “Connect Microsoft 365 (Outlook, Teams, OneDrive, OneNote, Planner, To Do, Contacts)” on Your connections, press it, pick your work, school or personal Microsoft account, and say yes on Microsoft's page. If your organisation asks for an admin's approval, your IT admin approves Nirvaana once and you connect again.

In your own conversation, it sees your Outlook mail, calendar and contacts, your Teams chats, your OneDrive files (Word, Excel and PowerPoint included), your OneNote pages and your Planner and To Do tasks, when you ask: a search, and the one it opens. It reads your mail, Teams and files and changes none of them, and it can add, move or cancel your own calendar events, each only with your approval. Teams channels come only where your organisation allowed them, and SharePoint and Planner need a work or school account. If you connected before one of these was added, Nirvaana says so when you ask, and you reconnect once to say yes to it. “Disconnect” ends it here; Microsoft keeps Nirvaana on its list of your apps until you remove it there, and the page links to where.

Where it is switched on, it can also add an event to your Outlook calendar (Outlook emails each guest you name an invitation), and move or cancel an event you organize (Outlook tells its guests). Each is a card under “Before it goes out” that names every guest and says exactly what changes, and nothing happens until you press “Approve”. If you connected before this was switched on, disconnect and connect again, and allow calendar changes on Microsoft's page. To move or cancel an event, ask what's on first, then ask for the change in your next message.

If you see “Connect Power BI” on Your connections, press it, pick your work or school Microsoft account, and say yes on Microsoft's page. Power BI needs a work or school account; a personal one can't be read. If your organisation asks for an admin's approval, your IT admin approves Nirvaana once and you connect again.

In your own conversation, ask where a report is, what a dataset holds, or for a number from it (“what were sales by region last quarter?”). It sees your Power BI workspaces, reports, dashboards and datasets, when you ask: a report's pages, a dataset's tables and measures, and the rows a query reads. It only reads: it never changes a report, a dataset or a dashboard, and never starts a refresh. A question about the numbers needs your Power BI admin to allow queries, and you to be allowed to build on that dataset; if either is missing, Nirvaana says so. “Disconnect” ends it here; Microsoft keeps Nirvaana on its list of your apps until you remove it there.

If you see “Connect Meta (Facebook, Instagram, Ads)” on Your connections, press it, sign in to Facebook, and choose the Pages, Instagram accounts and ad accounts Nirvaana may read on Meta's page. Instagram needs a business or creator account linked to one of your Facebook Pages; a personal Instagram account can't be read.

In your own conversation, ask how your Page, your Instagram or your ads are doing, or “how did my Meta do this week?”. It sees your Facebook Pages' posts and insights, your Instagram professional account's media and insights, and your ad accounts' campaign results, when you ask. It only reads: it never posts, replies, messages or changes an ad. A connection lasts about 60 days; then Your connections asks you to connect again. “Disconnect” ends Nirvaana's access at Meta too, and removing Nirvaana in your Facebook settings (Settings and privacy, Business integrations) ends it here.

If you see them on your “Money” page (with your subscription, while they are opening), press “Connect Coinbase” or type your store's .myshopify.com address and press “Connect Shopify”, then say yes on their page. If you don't see them, they aren't open for you yet.

• Coinbase sees your wallets, what they hold and what moved lately, as your own money beside your banks. It can't buy, sell, send or convert anything.
• Shopify sees your store's orders: sales by day, refunds and what sells the most, next to your Stripe revenue. It never reads your customers, and can't change your store.

Only you see what they bring, and your own automations read it when you ask them to. Disconnect ends it at Coinbase or Shopify too.

Connect Canvas with your calendar feed link or an access token, and your school becomes a world with a moon for each class this term, with what's due on your Calendar and each class's Study filled from Canvas. It comes in as soon as you connect, grades stay off unless you turn them on, and it only reads. Canvas for students has the steps.

Where it is open, Claude, ChatGPT, Codex or another AI you connected to Nirvaana can read the apps you choose. On “Your connections”, under “Your AI”, press “Let your AI read this” beside an app. Nothing is shared until you do, and Gmail, Outlook and money ask you to tick a second yes.

• Your AI reads an app only when you ask it something about it, and what it reads is marked as data, never as instructions.
• Anything it wants to do in an app (an event, a draft, a page, an issue) is a card under “Before it goes out” that names the AI. Nothing happens until you press “Approve”.
• Disconnecting an app stops sharing it too. Not for anyone under 18.

A world's owner can have one or more GitHub repos keep the world up to date: its merged pull requests, new and closed issues, and releases. Each one comes in as something to say yes to first.

1. Open the world, then its “Settings” tab, press “Open connectors”, and on “A GitHub repo” press “Connect”.
2. On GitHub, install the Nirvaana app for your account or organisation and choose the repos. If your organisation's owners have to approve it, GitHub asks them; press Connect again once they have.
3. Back on the tab, tick the repos that should feed this world and press “Connect these”. “Disconnect” beside a repo stops it.

Where it is switched on, a world's owners and builders can ask, in their own conversation, for an issue or a comment in one of its repos. The card says “Posts as the Nirvaana GitHub app” and shows every word, and nothing is posted until you press “Approve”. The repo's GitHub owner first accepts the app's request to write issues, on GitHub.

If you don't see the card, it isn't open here yet.

A world can have its own private email address. Forward it an invoice, a client thread or a receipt, and it becomes a card on the world's page: who sent it, the subject, a line or two, and whether it looks like an invoice, a promise, a decision or just something to know. Its facts, its promises and the PDFs, images and text files it carries each wait for an “Approve” before the world keeps them.

1. Open the world, then its “Settings” tab and press “Open connectors”. If you own it, press “Let this world take email” on “Email this world”.
2. Press “Copy address” and forward mail to it from the email you sign in to Nirvaana with (the card shows which one). Everyone in the world can do the same from theirs. Mail forwarded from any other address of yours won't come in.
3. Only the world's own people can send it mail, each from the email they sign in with. A vendor or a client without a Nirvaana account can't write to it directly: forward their mail yourself. Mail from anyone else is turned away without a reply. So is mail we can't confirm really came from the address it names: some company mail isn't set up to prove that, so if yours doesn't come in, forward it from your own sign-in email instead. The card counts what was turned away in the last 7 days, and why.
4. On the world's page, the person it waits for (whoever forwarded it, or the world's owner) presses “Approve” or “Not this” on each promise and each file; everyone else sees whose Approve it waits for. A file is only fetched and put in the world's “Files” after its Approve, and only for a few days after the email came in: after that the card says “Too late to keep: forward it again.” Facts wait with your other approvals, marked as coming from a forwarded email and whose.

Keep the address private. If it gets out, “New address” makes another and the old one stops taking mail. What an email says is read as the sender's words, never as something to do: nothing in it is done, kept or sent until someone presses “Approve”, and Nirvaana never replies to it. If an email talks about new bank or payment details, the card says so: check with the sender on a phone number you already have before paying. Files are checked for their type (only PDFs, images and text files up to 10 MB), not scanned for viruses. If the world gets a lot of email in a day, the rest show as a small card Nirvaana didn't read. Not for anyone under 18.

If you connected Gmail and own a shared world, Nirvaana can keep checking that inbox for the world, the way a team keeps an eye on hello@. It drafts a reply to each new email for your approval. Only email from the world's own people becomes a card the world sees.

1. On “Your connections”, under “Keep checking this inbox” on the Gmail card, pick the world and press “Turn on”. Only a shared world you own can be picked. “Turn off” stops it.
2. New email is picked up within a minute or two. Nirvaana drafts a reply from its public help pages, and it waits for your approval under “Before it goes out” in your own day. Your yes puts it in your Gmail Drafts; nothing is ever sent. Newsletters, notices and spam are left alone.
3. Email from someone in the world, sent from the email they sign in to Nirvaana with, also becomes a card on the world's page under “Inbox”, as long as their email's domain can prove the mail is really theirs (Gmail and most company email can; a domain set up without that proof can't). Email from anyone else, above all anyone without a Nirvaana account in that world, is yours alone: the world's people never see it, and its reply waits in your day like any other.

What an email says is read as the sender's words, never as something to do. A world's busy day gets one line with the counts, and never who wrote.

• Import from Slack — upload your workspace's Slack export and choose which channels become worlds. See Moving your Slack in.
• Import a team history — paste a group chat, a doc or notes, or drop an export from Notion, Asana, Linear or Trello, and see a draft of the world first.
• Meeting notes — a world's owners and builders paste or drop a meeting's notes, and what they come to waits for a yes before it goes into the world.
• Team chat capture — the world's owner can have its Team chat keep its “Due and waiting” up to date. Everyone there sees a line saying it is on.

Each is a card under the world's connectors (its “Settings” tab, then “Open connectors”). One that isn't open for that world isn't shown.

If you keep a Slack workspace in sync and posting is switched on, you can ask in your own conversation for a message in one of its linked channels. The card says “Posts as the Nirvaana app in #channel” and shows every word, and nothing is posted until you press “Approve”. The app posts only where it is a member; in a private channel, someone there adds it with /invite @Nirvaana. It posts only while you still own the world the channel feeds, and in a private channel only while you are still in it.

“Disconnect” beside any of yours on Your connections ends it at once, and you can connect it again later. Tick “Also forget what Nirvaana kept from it” there, and what it learned through that app goes too; otherwise it stays, and you can ask Nirvaana to forget anything.