> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nouxdigital.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Noux MCP

> Model Context Protocol access to your Noux organization for AI assistants and automation.

The Noux MCP server lets AI clients such as Cursor and Claude Desktop query — and optionally modify — your organization's Noux data using the [Model Context Protocol](https://modelcontextprotocol.io/).

<Note>
  Tokens are **personal** — each token acts as you within your organization. Read tools are available with any MCP token; write tools require the `mcp:write` scope.
</Note>

## What you can do

Connect an MCP client to:

* List rooms, members, and visitors
* Read room conversations, comments, and invitations
* Preview room invitation defaults before sending (`get_room_invitation_defaults`; requires ShareRoom on the room, not `mcp:write`)
* Query mutual action plans with tasks, assignees, due dates, and progress
* Access notetaker meetings, transcripts, summaries, and coaching
* Pull activity data for reporting
* Browse organization key documents and folders
* **With write scope:** post room comments, send room invitations, send room update emails, spread key documents into rooms, and create or update mutual action plans

## MCP vs REST API

|                  | **Noux MCP**                                                                                                    | **REST API**                                            |
| ---------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| **Purpose**      | AI assistants working with your data                                                                            | Application integrations and automation                 |
| **Auth**         | Personal MCP token or OAuth                                                                                     | Organization API key                                    |
| **Read access**  | Yes (`mcp:read`)                                                                                                | Yes                                                     |
| **Write access** | Selected actions (`mcp:write`) — comments, invitations, notifications, key document spread, mutual action plans | Full create/update API                                  |
| **Docs**         | [MCP tools](/mcp/tools)                                                                                         | [API reference](/api/overview)                          |
| **Setup**        | [Integrations → MCP](https://noux.app/integrations/mcp)                                                         | [Integrations → API](https://noux.app/integrations/api) |

Use MCP when an AI assistant needs context about your sales rooms and meetings, or to perform a focused set of write actions on your behalf. Use the REST API when your own software needs broader create/update workflows.

## Transport and endpoint

Noux MCP uses **Streamable HTTP** at:

```
https://mcp.noux.app/mcp
```

The same URL is shown in the Noux app under **Integrations → MCP**.

**Claude Desktop** authenticates via OAuth when you connect the custom connector — no manual header.

**Cursor and automation** send a Bearer token on every request:

```
Authorization: Bearer <your-mcp-token>
```

## Capabilities

Call the `get_info` tool after connecting to confirm your organization id, user id, and token capabilities:

* `read_only` — always present; all read tools are available
* `write` — present when the token includes `mcp:write`; exposes write tools (`add_room_comment`, `send_room_invitations`, `send_room_update_notifications`, `add_key_document_to_rooms`, and mutual action plan write tools)

Read tools are annotated with `readOnlyHint: true`. Write tools use `readOnlyHint: false`.

## Authentication

| Client              | How to authenticate                                                                          |
| ------------------- | -------------------------------------------------------------------------------------------- |
| **Claude Desktop**  | OAuth — add a [custom connector](https://mcp.noux.app/mcp) and sign in to Noux when prompted |
| **Cursor, scripts** | Personal Bearer token from [Integrations → MCP](https://noux.app/integrations/mcp)           |

Production MCP URL: `https://mcp.noux.app/mcp`

## Next steps

1. [Getting started](/mcp/getting-started) — tokens (for Cursor) or OAuth overview (for Claude)
2. [Claude Desktop](/mcp/clients/claude-desktop) or [Cursor](/mcp/clients/cursor) — client-specific setup
3. [Tool reference](/mcp/tools) — all available tools, inputs, and pagination