> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-chore-myaccount-api-autoupdate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Integrate Auth0 Model Context Protocol (MCP) Server with your AI clients.

# Getting Started with Auth0 Model Context Protocol (MCP) Server

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Early Access"
  };
  const stageText = stageTextMap[stage] || "a product release stage";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>This feature is available for {linkify(`${plans} plans`, "https://auth0.com/pricing")}. </>}
            {contact && "To participate, contact " + contact + ". "}
            {terms && <>By using this feature, you agree to the applicable Free Trial terms in Okta's {linkify("Master Subscription Agreement", "https://www.okta.com/legal")}.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>The {feature} feature is in {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 MCP Server" stage="beta" />

<Card title="Before you start">
  * Install [Node.js v18 or higher](https://nodejs.org/en/download) on your system.
  * Create an active [Auth0 account](https://auth0.com/)with administrative permissions.
  * Install at least one supported MCP client ([Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/downloads), [Windsurf](https://www.windsurf.com/editor), [VS Code](https://code.visualstudio.com/download), [Claude Code](https://claude.ai/download), or [Gemini CLI](https://github.com/google-gemini/gemini-cli), for example).
</Card>

Empower your team and your users by installing [Auth0 Model Context Protocol (MCP) Server](/docs/get-started/auth0-mcp-server) and integrating with several commonly-used [MCP clients](https://modelcontextprotocol.io/clients).

## Installation and configuration

Install Auth0 MCP Server by running one of these commands in your terminal:

### For Claude Desktop (default)

```bash lines theme={null}
npx @auth0/auth0-mcp-server init
```

### For Cursor

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client cursor
```

### For Windsurf

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client windsurf
```

### For VS Code

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client vscode
```

You will be prompted to choose a configuration scope:

* **Global**: Available in all VS Code instances.
* **Workspace**: Available only in a specific project or repository.

The command automatically configures the appropriate `mcp.json` file based on your selection.

### For Claude Code

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client claude-code
```

You will be prompted to choose a configuration scope:

* **User**: Written to `~/.claude.json` and available across all your projects.
* **Project**: Available only in the current project.

### For Gemini CLI

```bash lines theme={null}
npx @auth0/auth0-mcp-server init --client gemini
```

### Other MCP clients

To use Auth0 MCP Server with any other MCP Client, you can manually add this configuration to the client and restart for changes to take effect:

```json lines theme={null}
{
  "mcpServers": {
    "auth0": {
      "command": "npx",
      "args": ["-y", "@auth0/auth0-mcp-server", "run"],
      "capabilities": ["tools"],
      "env": {
        "DEBUG": "auth0-mcp"
      }
    }
  }
}
```

## Authenticate with Auth0

Your browser will automatically open to initiate the <Tooltip tip="OAuth 2.0: Authorization framework that defines authorization protocols and workflows." cta="View Glossary" href="/docs/glossary?term=OAuth+2.0">OAuth 2.0</Tooltip> device <Tooltip tip="OAuth 2.0: Authorization framework that defines authorization protocols and workflows." cta="View Glossary" href="/docs/glossary?term=authorization+flow">authorization flow</Tooltip>. Log into your Auth0 account and grant the requested permissions.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Credentials are securely stored in your system's keychain. You can optionally verify storage through your keychain management tool.
</Callout>

## Verify your integration

### Claude Desktop

1. Restart Claude Desktop to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Claude Desktop, click on the **Tools** icon and verify that Auth0 tools (for example, `auth0_create_action` or `auth0_delete_application`) show up in the **Available MCP Tools** list.
3. Begin a conversation with Claude Desktop and ask help managing your Auth0 tenant.

### Cursor

1. Restart Cursor to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Cursor, open **Settings > MCP** and verify that **Auth0** appears in the **MCP Servers** list.
3. Begin a conversation with Cursor and ask for help managing your Auth0 tenant.

### Windsurf

1. Restart Windsurf to ensure it recognizes the newly installed Auth0 MCP Server.
2. In Windsurf, open **Windsurf Settings > Cascade** and verify that **Auth0** appears in the **Model Context Protocol (MCP) Servers** list.
3. Begin a conversation with Windsurf and ask for help managing your Auth0 tenant.

### VS Code

1. Restart VS Code to ensure it recognizes the newly installed Auth0 MCP Server.
2. In VS Code, open Copilot Chat in agent mode and verify that Auth0 tools are available.
3. Begin a conversation and ask for help managing your Auth0 tenant.

### Claude Code

1. Restart Claude Code to ensure it recognizes the newly installed Auth0 MCP Server.
2. Verify that Auth0 tools (for example, `auth0_create_action` or `auth0_list_applications`) are available in your session.
3. Begin a conversation with Claude Code and ask for help managing your Auth0 tenant.

### Gemini CLI

1. Restart Gemini CLI to ensure it recognizes the newly installed Auth0 MCP Server.
2. Begin a conversation with Gemini CLI and ask for help managing your Auth0 tenant.

## Common troubleshooting steps

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Most connection issues can be resolved by configuring the Auth0 MCP server and restarting the MCP client.
</Callout>

#### Get command line help:

View a list of supported commands and usage examples with:

```bash lines theme={null}
npx @auth0/auth0-mcp-server help
```

#### Authentication issues

Ensure correct permissions in your Auth0 tenant and try re-initializing with:

```bash lines theme={null}
npx @auth0/auth0-mcp-server init
```

#### Connection failures:

1. Confirm the MCP server is actively running with:

   ```ps lines theme={null}
   ps aux | grep auth0-mcp
   ```

2. Restart your AI client after verifying the server is running.

#### Claude Can't Connect to the Server error:

1. Restart Claude Desktop after installation.
2. Check that the server is running with:

   ```ps lines theme={null}
   ps aux | grep auth0-mcp
   ```

#### API errors:

Check your Auth0 token permissions and expiration. Enable debug mode (see below) to view detailed logs.

## Debug configuration issues

#### Enable debug mode

Enable debug mode to view detailed logs:

```bash lines theme={null}
export DEBUG=auth0-mcp
```

#### Debug client logs

Get detailed MCP client logs from Claude Desktop:

```bash lines theme={null}
# Follow logs in real-time
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
```

Get detailed MCP server logs by running the Auth0 MCP Server in debug mode:

```bash lines theme={null}
DEBUG=auth0-mcp npx @auth0/auth0-mcp-server run
```

#### Advanced debugging using MCP Inspector

For advanced troubleshooting, use the MCP Inspector:

```bash wrap lines theme={null}
npx @modelcontextprotocol/inspector -e DEBUG='auth0-mcp' @auth0/auth0-mcp-server run__text in bold__
```

## Next steps

Explore the full capabilities of Auth0 MCP Server by visiting our [Auth0 Model Context Protocol (MCP) Server Tools Reference](/docs/get-started/auth0-mcp-server/auth0-mcp-tools-reference), or check out our Auth0 Model Context Protocol Server Guides for practical examples and use cases.