NirvaanaHelp

Use Nirvaana in ChatGPT, Codex and Gemini

Nirvaana works in any app that can add a remote MCP server (sometimes called a custom connector or an app), not only Claude. Every app is given the same address, signs you in on Nirvaana's own page, and gets the same thing: it reads what you can read, and hands new facts to Nirvaana, which decides what to keep.

Add it in one click

Each button opens the app with Nirvaana filled in, or gives you one line to copy. Every one ends on Nirvaana's own page, where you press Allow: nothing connects without you.

  • Add to ChatGPTOpen ChatGPT
    1. In ChatGPT's settings, open Apps, and turn on developer mode under Advanced if it asks.
    2. Create an app called Nirvaana with this address, and choose OAuth:https://nirvaana.ai/api/mcp
    3. Press Allow on Nirvaana's page, then turn Nirvaana on in a chat.
  • Add to Codex In a terminal. Codex sends you to Nirvaana to sign in; press Allow.codex mcp add nirvaana --url https://nirvaana.ai/api/mcp
  • Add to Gemini CLI In a terminal. Then, in Gemini CLI, /mcp auth nirvaana and press Allow.gemini extensions install https://github.com/Nirvaana-AI-INC/nirvaana-claude-plugin
  • Add to Muse
    1. In Muse Code, add this under mcp_servers in ~/.config/muse/settings.json (keep what is there; the file also needs "schema_version": 1):{"mcp_servers":{"nirvaana":{"transport":"streamable_http","url":"https://nirvaana.ai/api/mcp"}}}
    2. Then run this, and press Allow on Nirvaana's page:muse mcp login nirvaana
    3. The Muse app: adding an MCP address there isn't confirmed by Meta yet, so these steps are for Muse Code.
  • Add to CursorCursor asks to install Nirvaana. Press Install, then Allow on Nirvaana's page.
  • Add to VS CodeVS Code asks to install Nirvaana. Press Install, then Allow on Nirvaana's page.

The address

https://nirvaana.ai/api/mcp

There is no key to paste. When the app connects, Nirvaana asks you to sign in and shows a page called “Connect an app” with the app's name. Press Allow only if you just started it yourself.

ChatGPT

Custom apps in ChatGPT need developer mode, which your plan or your workspace's admin may have to allow.

  1. In ChatGPT's settings, open “Apps”, and turn on developer mode under Advanced if it asks.
  2. Create an app called Nirvaana with the address above, and choose OAuth.
  3. Sign in to Nirvaana, and press Allow.
  4. In a chat, turn Nirvaana on, then ask it what worlds you're in.

Codex CLI

In the Mac or Windows app (0.1.8 or later), Connections, then Connect my AI apps, adds Nirvaana to Codex with one Approve and opens its sign-in. Or one command: npx @nirvaana/mcp setup finds Codex, adds Nirvaana, and offers to sign it in. If it prints only a usage line, use the lines below. By hand:

  1. codex mcp add nirvaana --url https://nirvaana.ai/api/mcp. Codex starts Nirvaana's sign-in at once: it opens Nirvaana's page in your browser, or prints its address to open. Press Allow there.
  2. If Codex didn't open Nirvaana's page, or you closed it, or need to sign in again later: codex mcp login nirvaana, then press Allow.

Gemini CLI

Connect my AI apps, in the Mac or Windows app (0.1.8 or later), adds Nirvaana to Gemini CLI too; then run /mcp auth nirvaana there. npx @nirvaana/mcp setup finds Gemini CLI as well. Or by hand:

  1. gemini mcp add -s user -t http nirvaana https://nirvaana.ai/api/mcp
  2. In Gemini CLI, type /mcp auth nirvaana, then press Allow on the page Nirvaana shows.

Cursor and VS Code

Add to Cursor and Add to VS Code, above, open each app's own install prompt. Or, in a terminal, npx @nirvaana/mcp setup finds them and, after showing you the entry and asking, adds Nirvaana to the file each one reads: ~/.cursor/mcp.json for Cursor, and VS Code's user mcp.json (the file “MCP: Open User Configuration” opens). Every other server stays as it is, and a copy of the file is kept first. The first time the app starts Nirvaana, press Allow on the page Nirvaana shows.

npx @nirvaana/mcp setup --uninstall takes out exactly these, after a copy of each file: Nirvaana's entry in Cursor's and VS Code's mcp.json, its Claude Code hooks in ~/.claude/settings.json, and the preferences block in ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md and ~/.gemini/GEMINI.md. Nothing else in those files changes. It prints the commands that take Nirvaana out of Claude Code, Codex and Gemini CLI, and runs none of them. It leaves the Nirvaana entry that --local put in Claude Desktop's claude_desktop_config.json, the Nirvaana line in a project's CLAUDE.md, AGENTS.md or GEMINI.md, and this terminal's sign-in (npx @nirvaana/mcp logout ends it).

Muse Code

  1. In Muse Code, add this under mcp_servers in ~/.config/muse/settings.json. Keep what is already there; the file also needs "schema_version": 1.
    {"mcp_servers":{"nirvaana":{"transport":"streamable_http","url":"https://nirvaana.ai/api/mcp"}}}
  2. muse mcp login nirvaana, then press Allow on the page Nirvaana shows.

The Muse app: adding an MCP address there isn't confirmed by Meta yet, so these steps are for Muse Code.

Sending work to your coding sessions

Codex CLI and Gemini CLI read and keep through Nirvaana the way Claude Code does. A task you send to your computer from Nirvaana is picked up by the Nirvaana app for Mac and Windows, where Claude Code does it (see Work from your phone).

Fewer questions, in every app

Whichever app you connect, Nirvaana tells it the same rule: look it up before asking you. A status, a setting, a version, a plan, or whether something exists is one call away, so the app checks for itself and asks you only for decisions, approvals, money, legal, or what only you can see or know. Before it asks, it checks the question with Nirvaana's ask, which sends a question it could look up back to it with the call that answers it. More in Nirvaana in Claude Code.

If it doesn't work

  • The app says it can't sign in: remove Nirvaana from it, add it again, and press Allow.
  • The app keeps asking you to sign in again: check the address is exactly the one above, then connect again.
  • To disconnect, sign the app out in Nirvaana under Settings, Apps and terminals, and remove it from the app.

Claude has its own page: Connect Claude.