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

# MCP (Model Context Protocol)

> Connect Caret to AI assistants like Claude Desktop, Cursor, and Windsurf using the Model Context Protocol.

MCP is an open protocol that lets AI assistants access your Caret meeting data directly. Ask your AI about past meetings, search your knowledge base, and reference transcripts — all without leaving your workflow.

## Supported Clients

<CardGroup cols={3}>
  <Card title="Claude Desktop" icon="message-bot">
    Anthropic's desktop AI assistant.
  </Card>

  <Card title="Cursor" icon="code">
    AI-powered code editor.
  </Card>

  <Card title="Any MCP Client" icon="plug">
    Any client that supports the Model Context Protocol.
  </Card>
</CardGroup>

## Quick Setup

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Open Settings">
        Open Claude Desktop and go to **Settings > MCP Servers**.
      </Step>

      <Step title="Add Server">
        Click **Add** and enter the server URL:

        ```
        https://api.caret.so/mcp
        ```
      </Step>

      <Step title="Sign In">
        Claude will open a browser window. Sign in with your Google account.
      </Step>

      <Step title="Select Workspace">
        Choose the Caret workspace you want to connect.
      </Step>

      <Step title="Start Using">
        You're connected. Try asking Claude about your meetings.
      </Step>
    </Steps>

    You can also manually add the server in your `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Open MCP Settings">
        Go to **Cursor Settings > MCP**.
      </Step>

      <Step title="Add Server">
        Click **Add new MCP server** and enter `https://api.caret.so/mcp` as the URL.
      </Step>

      <Step title="Authenticate">
        Sign in via the browser window when prompted and select your workspace.
      </Step>
    </Steps>

    Or add directly to `.cursor/mcp.json` in your project:

    ```json theme={null}
    {
      "mcpServers": {
        "caret": {
          "type": "streamable-http",
          "url": "https://api.caret.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Other Clients">
    Use these settings for any MCP-compatible client:

    * **Server URL**: `https://api.caret.so/mcp`
    * **Transport**: Streamable HTTP
    * **Authentication**: OAuth 2.0 (handled automatically by most clients)

    If your client doesn't support OAuth, use an API key instead — see below.
  </Tab>
</Tabs>

## API Key Authentication

If your MCP client does not support OAuth, you can authenticate with an API key.

<Steps>
  <Step title="Create API Key">
    Go to **Settings > Developer** in Caret and click **Create API Key**.
  </Step>

  <Step title="Assign Scopes">
    Select `notes` and `users` scopes for full MCP tool access.
  </Step>

  <Step title="Configure Client">
    Set the API key as a Bearer token in your MCP client's authorization header.
  </Step>
</Steps>

<Warning>
  Keep your API key secure. Never share it in public repositories or client-side
  code.
</Warning>

## What You Can Do

All tools are **read-only** and scoped to your workspace.

| Capability            | Example Prompt                                    |
| :-------------------- | :------------------------------------------------ |
| List meeting notes    | "Show me my meetings from last week"              |
| Get full note details | "What was discussed in the Q3 planning call?"     |
| Search notes by title | "Find meetings about pricing"                     |
| Search knowledge base | "What did the customer say about our competitor?" |
| View workspace info   | "What workspace am I connected to?"               |
| List team members     | "Who's on the team?"                              |

For full tool schemas and parameters, see the [MCP Tools Reference](/api-reference/mcp/tools).

## Troubleshooting

| Issue               | Solution                                                          |
| :------------------ | :---------------------------------------------------------------- |
| Connection failed   | Verify the URL is exactly `https://api.caret.so/mcp`              |
| Unauthorized error  | Re-authenticate or check that your API key has the correct scopes |
| No results returned | Ensure your workspace has meeting notes with completed status     |
| Workspace not found | Confirm you're a member of the workspace you selected             |