MCP for organization and user management

Use Retool's MCP server to manage your organization and its users.

MCP server for Retool Availability
Cloud	Public beta	Available on all plans

You can connect to Retool's MCP server directly from your coding environment so that agents can interact with your Retool organization's settings and users.

Retool's MCP server provides access to Retool functionality in an external environment. This functionality is distinct from the MCP resource, which enables you to integrate external functionality as a native integration in Retool apps, workflows, and agents.

Features

The MCP server provides the following key features:

• The ability to manage organizations and users using a list of predefined tools.
• Authentication via OAuth 2.0.
• Streamable HTTP transport.

Use cases

The following use cases are examples of what can be accomplished using the MCP server:

• Write queries against resources to power data analysis.
• Bulk-invite users or manage pending invites.
• Audit the users who have access to your organization.
• Inspect organization and resource environment configurations.
• List all connected resources and see their configurations.

Tools

Through Retool's MCP server, you can interact with several sets of tools:

• Apps
• Environments
• Folders
• Organizations
• Resources
• User Invites
• Users
• Workflows

For a full list of available tools, refer to the MCP tools reference, or install the MCP and run tools/list.

Connect MCP server

You can connect Retool's MCP server to an MCP-compatible client using the following details:

• URL: https://<your-retool-instance>/mcp (e.g. https://example.retool.com/mcp)
• Transport: HTTP
• Authentication: OAuth 2.0

Once you authenticate your MCP with OAuth 2.0, you might have to restart your coding agent in order to use the MCP.

Common coding agents

The following examples show how to connect to the MCP server with common coding agents:

Retool Agents

To configure the MCP server as a tool for use in Retool Agents, complete the following steps:

1. Navigate to the Resources tab in Retool. Click Create new > Resource, and select MCP Server.
2. Configure the resource:
   1. Title: Retool MCP
   2. Description: An MCP server for interacting with Retool.
   3. Server URL: https://<your-retool-instance>/mcp
   4. Click Auto-configure authentication.
   5. Scroll down and click Connect with OAuth.
3. Navigate to a new or existing agent and add a new tool.
   1. Click Add new tool.
   2. Select Connect to MCP server.
   3. From the dropdown, select the MCP server you created in the previous step.
   4. Click Save.
4. Test out your agent from the Chat tab.

Claude Code

To configure the MCP server for Claude Code, complete the following steps:

1. From your terminal, run the following command:

   claude mcp add --transport http retool https://<your-retool-instance>/mcp

2. Exit your Claude Code session, and start a new session.
3. Run /mcp, and select the retool MCP, which needs authentication. A browser window opens and asks you to select the desired scopes.
4. Authenticate, and return to Claude Code. The MCP is ready to use.

ChatGPT

You must have Developer mode enabled in ChatGPT in order to add Retool's MCP server.

To configure the MCP server for ChatGPT, use the following steps:

1. In ChatGPT, navigate to Settings > Apps.
2. In the Advanced settings section, click Create app.
3. Enter the following information:
   1. Name: Retool
   2. MCP Server URL: https://<your-retool-instance>/mcp
   3. Authentication: OAuth
4. Click Create. A browser window opens for OAuth consent.
5. Authorize the requested scopes and return to ChatGPT.

Codex

To configure the MCP server via the CLI for Codex, complete the following steps:

1. From your terminal, run the following command:

   codex mcp add retool --url https://<your-retool-instance>/mcp

2. A browser window opens and asks you to select the desired scopes.
3. Authenticate, and return to Codex. The MCP is ready to use.

Cursor

To configure the MCP server in Cursor, complete the following steps:

1. Open Settings > MCP (or edit .cursor/mcp.json in your project root). Add your Retool MCP server:

   {
   "mcpServers": {
      "retool": {
         "type": "http",
         "url": "https://<your-retool-instance>/mcp"
      },
      ...other mcp servers
   }
   }

2. Restart Cursor. The OAuth flow triggers automatically when a tool is first invoked.

Kiro

To configure the MCP server for the Kiro CLI, complete the following steps:

1. From your terminal, run the following command:

   kiro-cli mcp add --name "Retool" --scope global --url "https://<your-retool-instance>/mcp"

2. Exit your Kiro CLI session, and start a new session.
3. Run /mcp, and select the retool MCP, which needs authentication. Click the link to redirect to the OAuth authentication.
4. Select the desired scopes and click Authorize.
5. Return to Kiro CLI. The MCP is ready to use.