Getting Started with Model Context Protocol (MCP)

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

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

npx @auth0/auth0-mcp-server init

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

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

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"
      }
    }
  }
}

Your browser will automatically open to initiate the OAuth 2.0 device authorization flow. Log into your Auth0 account and grant the requested permissions.

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.

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.

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.

View a list of supported commands and usage examples with:

npx @auth0/auth0-mcp-server help

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

npx @auth0/auth0-mcp-server init

1. Confirm the MCP server is actively running with:

   ps aux | grep auth0-mcp

   Was this helpful?

   Yes /No

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

1. Restart Claude Desktop after installation.

2. Check that the server is running with:

   ps aux | grep auth0-mcp

   Was this helpful?

   Yes /No

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

Enable debug mode to view detailed logs:

export DEBUG=auth0-mcp

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

For advanced troubleshooting, use the MCP Inspector:

npx @modelcontextprotocol/inspector -e DEBUG='auth0-mcp' @auth0/auth0-mcp-server run__text in bold__

Explore the full capabilities of Auth0 MCP Server by visiting our Model Context Protocol Tools Reference, or check out our Model Context Protocol Guides for practical examples and use cases.