Skip to main content

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)

​
For Cursor

​
For Windsurf

​
For VS Code

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

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

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

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

​
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

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:

​
Authentication issues

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

​
Connection failures:

  1. Confirm the MCP server is actively running with:
  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:

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

​
Debug client logs

Get detailed MCP client logs from Claude Desktop:
Get detailed MCP server logs by running the Auth0 MCP Server in debug mode:

​
Advanced debugging using MCP Inspector

For advanced troubleshooting, use the MCP Inspector:

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