Documentation
The Nirvani connector is a remote MCP server at https://mcp.nirvani.ai/mcp. Claude connects to it over HTTPS, you sign in with your Nirvani email, and from then on Claude can act in your workspace on your behalf.
Connect from Claude
- In Claude, open Customize, then Connectors.
- Find Nirvani in the directory and choose Connect, or choose Add custom connector and paste
https://mcp.nirvani.ai/mcp. This link opens the dialog with the address filled in: Connect Nirvani to Claude. - Claude opens the Nirvani sign-in page. Enter your work email. We send a six digit code to that email, or your Nirvani admin gives you one.
- Enter the code, pick the workspace if you belong to more than one, review what Claude is asking for, and choose Allow.
Claude Code users: run claude mcp add --transport http nirvani https://mcp.nirvani.ai/mcp and complete the same sign-in in the browser window that opens.
Connect from Meta Muse and other agents
Nirvani is a standard remote MCP server, so any agent that supports remote MCP can use it. Agents that support OAuth sign in exactly like Claude. Agents that ask for a credential instead, such as a Muse custom connector, use a Nirvani connection key: your Nirvani admin issues one for your email, limited to read or to read and write, and you paste it when the agent asks for the API key or credential. The agent keeps it in its own secure credential store; Nirvani stores only a hash and can revoke it at any time.
In Muse, ask: "Create a custom connector to Nirvani. It is a remote MCP server at https://mcp.nirvani.ai/mcp over streamable HTTP, authenticated with a bearer token." When Muse asks for the credential, enter your connection key. If your version of Muse offers OAuth sign-in for custom connectors, you can use that instead and no key is needed.
Before you can connect
Your email must be a member of a Nirvani workspace that is enabled for Claude. Your Nirvani admin enables a workspace and adds members. If sign-in says your email is not recognized, ask your admin to add you.
Permissions
At sign-in you grant two permissions. Read lets Claude look things up. Write lets Claude create and change records and send messages. You can leave write unchecked for a read-only connection. Claude also asks you to confirm before it runs any action that changes data.
Example prompts
- "Search my Nirvani contacts for anyone at Bright Smiles Dental."
- "Show me Ann Lee's contact record and her last five messages."
- "List the stages in the Sales pipeline."
- "Move the Acme Dental deal to Proposal Sent and set its value to 12000."
- "What open slots does the Consults calendar have on Thursday afternoon?"
- "Book Ann Lee for Thursday at 2pm on the Consults calendar, titled Initial consult."
- "Add a note to Ann's record: called, left voicemail, follow up Friday."
- "Email Ann the pricing summary we discussed, subject Nirvani pricing."
Actions Claude can take
Read
| Tool | Name | What it does |
|---|---|---|
nirvani_whoami | Connected workspace | Show which Nirvani workspace and user this connection acts as, and what it is allowed to do. |
nirvani_contacts_search | Search contacts | Find contacts in the Nirvani workspace by name, email, phone, or company. |
nirvani_contact_get | Get contact | Read one contact's full profile by contact id. |
nirvani_pipelines_list | List pipelines | List sales pipelines and their stages with ids. |
nirvani_opportunities_search | Search opportunities | Find deals by name, pipeline, stage, status, or contact. |
nirvani_calendars_list | List calendars | List booking calendars in the workspace with ids. |
nirvani_calendar_events_list | List appointments | List appointments in a date range, optionally for one calendar or user. |
nirvani_calendar_free_slots | Find free slots | List open booking slots for a calendar between two dates. |
nirvani_conversations_search | Search conversations | Find message threads, optionally for one contact or by text. |
nirvani_conversation_messages | Read messages | Read the recent messages in one conversation. |
Write
| Tool | Name | What it does |
|---|---|---|
nirvani_contact_create | Create contact | Create a new contact in the Nirvani workspace. |
nirvani_contact_update | Update contact | Change fields on an existing contact. Overwrites the fields you pass. |
nirvani_contact_add_tags | Add tags | Add one or more tags to a contact. |
nirvani_contact_add_note | Add note | Add a note to a contact's timeline. |
nirvani_opportunity_create | Create opportunity | Create a deal for a contact in a pipeline stage. |
nirvani_opportunity_update | Update opportunity | Move a deal to another stage, change its status, value, name, or owner. |
nirvani_appointment_book | Book appointment | Book an appointment for a contact on a calendar. |
nirvani_message_send | Send message | Send an SMS or email to a contact from the workspace. |
The connector never moves money, issues invoices, or deletes records.
For Nirvani admins
Admins enable a workspace for Claude, add or sync its members, and issue sign-in codes through the Nirvani admin API on this server. Every admin request carries the admin key as a bearer token.
POST /admin/accounts enable a workspace
POST /admin/accounts/{id}/members add a member
POST /admin/accounts/{id}/members/sync pull members from the workspace user list
POST /admin/accounts/{id}/keys issue a connection key for a member (read, or read and write)
GET /admin/accounts/{id}/keys list active connection keys
DELETE /admin/accounts/{id}/keys/{keyId} revoke a connection key
POST /admin/login-codes issue a one-time sign-in code for a member
GET /admin/audit review recent actions
Contact support to get a workspace enabled.
Disconnect
In Claude, open Customize, Connectors, and remove Nirvani. Your Nirvani admin can also revoke a workspace or member at any time, which ends every connection for it.
Technical details
- Transport: Streamable HTTP at
https://mcp.nirvani.ai/mcp. - Authentication: OAuth 2.1 with PKCE, or a Nirvani connection key presented as a bearer token by agents that cannot complete OAuth. Discovery at
https://mcp.nirvani.ai/.well-known/oauth-authorization-serverandhttps://mcp.nirvani.ai/.well-known/oauth-protected-resource/mcp. Dynamic client registration and client ID metadata documents are supported. - Scopes:
nirvani:read,nirvani:write,offline_access. - Service: nirvani-mcp 1.0.0.