Troubleshoot tool errors

Use the error code in your message to find the cause and recovery steps. Some errors affect tools across apps, while others require changes in a specific app.

Resolve shared tool errors

These errors can occur with tools from different apps. Find the code or message you received in the table.

Error	What to check
ACTIONS_MISSING_REQUIRED_PARAMS	Required inputs for the tool
Tool Permission Error	The OAuth app's allowed callback URLs
TOOLS_ACCESS_DENIED	The connected account's access to the item or operation
TOOLS_ACCOUNT_DOMAIN_NOT_ALLOWED	The domain of the account used to connect
TOOLS_AUTH_CONFIG_INVALID	The tool's authentication settings
TOOLS_EXTERNAL_SERVICE_UNAVAILABLE	Availability of the app that the tool calls
TOOLS_FILE_LOCKED	File locks or check-out requirements in the app
TOOLS_HOST_UNREACHABLE	The server address, network access, and TLS connection
TOOLS_NOT_ENABLED	Where the tool is turned on and who can use it
TOOLS_OAUTH_CONSENT_DENIED	Permission granted during the app's sign-in flow
TOOLS_OAUTH_NO_REFRESH_TOKEN	A successful connection that can't refresh its access token
TOOLS_OAUTH_SESSION_EXPIRED	Whether the sign-in flow needs to start again
TOOLS_RATE_LIMITED	The app's request or usage limits
TOOLS_RECONNECT_REQUIRED	Whether the connected account needs to reconnect

Set up a remote MCP server

These codes apply when you add, connect, or refresh a remote MCP server, including servers managed through a connector's setup page.

Error code	What to check
MCP_DCR_NOT_SUPPORTED	Another authentication method that the server supports
MCP_DCR_REDIRECT_URI_REJECTED	The authorization server's allowed callback URLs
MCP_DCR_REJECTED	The authorization server's client registration requirements
MCP_SERVER_AUTH_REJECTED	The credentials sent to the MCP server
MCP_SERVER_INVALID_ENDPOINT	Whether the URL points to an MCP endpoint
MCP_SERVER_UNAVAILABLE	Server availability and network access

Resolve app-specific errors

Find these pages under the app's section in Troubleshooting → Error codes. They concern tool setup or requests, not connector indexing.

App	Error or message
Gmail	TOOLS_GMAIL_DISABLED
Google Cloud	GOOGLECLOUD_1
Google Workspace	Google Tool Errors
Snowflake	TOOLS_SNOWFLAKE_DEFAULTS_MISSING