Before you start

Empower your team and your users by installing Auth0 Model Context Protocol (MCP) Server and integrating with several commonly-used MCP clients.

​
Installation and configuration

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

​
For Claude Desktop (default)

npx @auth0/auth0-mcp-server init

​
For Cursor

npx @auth0/auth0-mcp-server init --client cursor

​
For Windsurf

npx @auth0/auth0-mcp-server init --client windsurf

​
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: 
{
  "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 device . Log into your Auth0 account and grant the requested permissions.
Credentials are securely stored in your system’s keychain. You can optionally verify storage through your keychain management tool.

​
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.

​
Common troubleshooting steps

Most connection issues can be resolved by configuring the Auth0 MCP server and restarting the MCP client.

​
Get command line help:

View a list of supported commands and usage examples with: 
npx @auth0/auth0-mcp-server help

​
Authentication issues

Ensure correct permissions in your Auth0 tenant and try re-initializing with: 
npx @auth0/auth0-mcp-server init

​
Connection failures:

  1. Confirm the MCP server is actively running with:
  ps aux | grep auth0-mcp
  1. 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 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: 
export DEBUG=auth0-mcp

​
Debug client logs

Get detailed MCP client logs from Claude Desktop: 
# 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: 
DEBUG=auth0-mcp npx @auth0/auth0-mcp-server run

​
Advanced debugging using MCP Inspector

For advanced troubleshooting, use the MCP Inspector: 
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, or check out our Auth0 Model Context Protocol Server Guides for practical examples and use cases.