create_app
Create App
Compatibility action. The current Retool API reference has no documented supported route for this app definition write. Edit or create the app in Retool, then read its metadata with list_apps or get_app.
Ask your agent in plain language. Each of these maps to a real tool on the server.
create_app
Compatibility action. The current Retool API reference has no documented supported route for this app definition write. Edit or create the app in Retool, then read its metadata with list_apps or get_app.
manage_group_members
Add or remove users from a permission group. Use "add" to add one or more users, or "remove" to remove the listed users. Removal is sequential; an error can follow a partial change.
delete_group
Delete a permission group from the Retool organization. This removes the group and all associated permissions.
list_apps
List all Retool applications in the organization. Supports pagination for organizations with many apps.
update_user
Update a Retool user's properties such as name, email, active status, or metadata. Only provide the fields you want to change.
manage_permissions
Grant or revoke access permissions for users or groups on Retool objects (apps, folders, resources, resource configurations). Supports access levels: **use**, **edit**, and **own**.
list_permissions
Query permissions in two ways: list all objects a user/group has access to, or list all users/groups that have access to a specific object.
get_user
Retrieve detailed information about a specific Retool user by their ID. Optionally includes the groups the user belongs to.
update_app
Compatibility action. The current Retool API reference has no documented supported route for this app definition write. Edit or create the app in Retool, then read its metadata with list_apps or get_app.
get_organization
Retrieve information about the current Retool organization, including its native organization ID and selected advanced settings. This is organization context, not current-user identity.
manage_folder
Create, update, or delete a folder in the Retool organization. Folders organize apps and resources into a hierarchy.
list_environments
List all environments (e.g., staging, production) configured in the Retool organization.
create_group
Create a new permission group in the Retool organization. Groups control access to apps, resources, and workflows. You can optionally add initial members during creation.
delete_user
Disable a user in the Retool organization. The legacy deleted flag reports a successful disable receipt; it does not mean permanent account erasure. This disables the user's access to the organization.
manage_space
Create, update, or delete a Space in the Retool organization. Spaces are isolated sub-environments for multi-tenant or multi-team setups.
list_resources
List all data source resources (database connections, API configurations, etc.) in the Retool organization. Supports pagination.
get_source_control_config
Retrieve the current source control configuration for the Retool organization. Returns repository, provider, branch, and selected non-secret connection metadata. Provider credentials and unsafe URLs are omitted.
get_workflow_run
Read an existing workflow run's status, workflow and trigger IDs, creation timestamp, and documented user-task details. This does not execute a workflow.
list_groups
List all permission groups in the Retool organization. Groups are the primary mechanism for assigning permissions to users.
delete_app
Request deletion of an exact Retool application. A successful native receipt does not prove permanent erasure of history, trash, or caches.
update_group
Update a permission group's settings including name, universal access levels, and organizational permissions. Only provide the fields you want to change.
list_spaces
List all Spaces (isolated sub-environments) in the Retool organization. Spaces are useful for multi-tenant or multi-team setups.
list_workflows
List all workflows in the Retool organization. Workflows automate processes and can be triggered by schedules, webhooks, or other events.
list_folders
List all folders in the Retool organization. Folders are used to organize apps and resources.
create_user
Create a new user in the Retool organization. Use this for programmatic user onboarding. This changes organization membership and may affect seat usage; it does not prove invitation delivery.
get_group
Retrieve detailed information about a specific permission group, including its members and access settings.
list_users
List users in the Retool organization with optional filtering by email, first name, or last name. Supports pagination for large user bases.
list_access_tokens
List all API access tokens configured for the Retool organization. Useful for auditing active API credentials.
manage_user_attributes
Set or delete custom attributes (key-value metadata) on a Retool user. Use the "set" action to update an existing attribute with a string or null, or "delete" to remove its value. The attribute name must already exist in Retool.
get_app
Read exact Retool app metadata. Call list_apps to discover app IDs. This does not export or edit an app definition.
get_resource
Read exact Retool data-source resource metadata. Call list_resources to discover resource IDs. Connection credentials are not returned.
get_workflow
Read exact Retool workflow metadata. Call list_workflows to discover workflow IDs. This does not execute or enable the workflow.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Programmatically manage a Retool organization's users, groups, apps, permissions, and infrastructure. Create, list, update, and delete users and permission groups. Manage app lifecycle including creating, organizing, and deleting apps and folders. Configure SSO, data source resources, environments, and source control settings. Control access permissions for apps and folders. Monitor workflow executions and retrieve run details. Manage Spaces for multi-tenant setups, custom component libraries, app themes, observability providers, API access tokens, and usage analytics.
Common questions about connecting Retool to AI agents with Metorial.