To get the permissions that you need to use Gemini Code Assist tools, ask your administrator to grant you the following IAM roles on the Google Cloud project:
Individual tools might require additional Google Cloud or third-party roles and permissions to use, or for specific use cases. If you encounter permissions errors, check with your administrator to make sure you have the correct roles and permissions.
Dependencies
Some tools have dependencies you must install or enable before use. Some examples of dependencies that might be required are:
An extension might need to be installed in your IDE.
A product or service might need to be enabled in your Google Cloud project.
An account or project might need to be created for a service.
You will be prompted to take the required actions the first time you prompt a tool in the Gemini Code Assist chat.
Configure a tool for use in the IDE
In your IDE, navigate to the Gemini Code Assist chat and prompt the tool you want to use by using the @ symbol followed by the name of the tool.
For example, the following prompt is sent to the Google Docs tool:
@GoogleDocs get my docs
You are prompted to connect the tool.
Click the link to connect the tool. The Gemini Code Assist Agents & Tools page opens.
Locate the tool that you want to use and then click Connect your account. The tool details page opens.
In the tool details page, click Connect and then follow the instructions to authenticate to the tool service and connect your account.
For a list of tools and some suggested prompts, see available tools.
Remove authorization from a tool
To remove authorization from a tool in your IDE, complete the following steps:
Find the account connector for the tool service you want to remove, and then click the name of the account connector. The connector details page opens.
In the row containing your account, click more_vertMore options.
Click Delete.
Your account is removed from the account connector. The tool is no longer authorized to access its service from your IDE.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-25 UTC."],[],[],null,["| **Preview**\n|\n| This product or feature is in preview. Products and features that are\n| in preview are available \"as is\".\n\nThis document describes how to configure Gemini Code Assist tools for\nuse in your IDE.\n\nTo learn more about Gemini Code Assist tools and view all available\ntools, read the [Gemini Code Assist tools overview](/gemini-code-assist/docs/tools-agents/tools-overview).\n\nBefore you begin\n\n1. Ask your administrator to do the following:\n\n 1. [Set up Gemini Code Assist Standard and Enterprise](/gemini-code-assist/docs/set-up-gemini-standard-enterprise).\n 2. [Enable Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/enable-tools-standard-enterprise).\n2. [Install the Gemini Code Assist plugin in your IDE](/gemini-code-assist/docs/set-up-gemini-standard-enterprise#use-ide).\n\nRequired roles To get the permissions that you need to use Gemini Code Assist tools, ask your administrator to grant you the following IAM roles on the Google Cloud project:\n\n\u003cbr /\u003e\n\n- [Gemini Code Assist Tools User](https://cloud.google.com/iam/docs/roles-permissions/cloudaicompanion#cloudaicompanion.codeToolsUser) (`roles/cloudaicompanion.codeToolsUser`)\n\nFor more information about granting roles, see\n[Manage access to projects, folders, and organizations](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n\nYou might also be able to get the required permissions through\n[custom roles](https://cloud.google.com/iam/docs/creating-custom-roles) or\nother [predefined roles](https://cloud.google.com/iam/docs/understanding-roles).\n\nIndividual tools might require additional Google Cloud or third-party roles and\npermissions to use, or for specific use cases. If you encounter permissions\nerrors, check with your administrator to make sure you have the correct roles\nand permissions.\n\n\nDependencies\n\nSome tools have dependencies you must install or enable before use. Some\nexamples of dependencies that might be required are:\n\n- An extension might need to be installed in your IDE.\n- A product or service might need to be enabled in your Google Cloud project.\n- An account or project might need to be created for a service.\n\nYou will be prompted to take the required actions the first time you prompt a\ntool in the Gemini Code Assist chat.\n\nConfigure a tool for use in the IDE\n\n1. In your IDE, navigate to the Gemini Code Assist chat and prompt\n the tool you want to use by using the `@` symbol followed by the name of\n the tool.\n\n For example, the following prompt is sent to the Google Docs tool: \n\n @GoogleDocs get my docs\n\n You are prompted to connect the tool.\n2. Click the link to connect the tool. The Gemini Code Assist\n **Agents \\& Tools** page opens.\n\n3. Locate the tool that you want to use and then click\n **Connect your account**. The tool details page opens.\n\n | **Note:** you can't connect your account if the tool hasn't been enabled by an administrator.\n4. In the tool details page, click **Connect** and then follow the instructions\n to authenticate to the tool service and connect your account.\n\nFor a list of tools and some suggested prompts, see\n[available tools](/gemini-code-assist/docs/tools-agents/tools-overview#available-tools-standard-enterprise).\n\nRemove authorization from a tool\n\nTo remove authorization from a tool in your IDE, complete the following steps:\n\n1. Navigate to Developer Connect.\n\n [Go to Developer Connect](https://console.cloud.google.com/developer-connect)\n2. Click **Account Connectors**.\n\n3. Find the account connector for the tool service you want to remove, and then\n click the name of the account connector. The connector details page opens.\n\n4. In the row containing your account, click\n more_vert**More options**.\n\n5. Click **Delete**.\n\n Your account is removed from the account connector. The tool is no longer\n authorized to access its service from your IDE.\n | **Note:** if you want to authorize the tool again with a different account, you might need to log out of the tool account and then log back in with the new account you want to authorize\n\nWhat's next\n\n- Try out the GitHub or GitLab tool by following the instructions in [Get started with Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/get-started-with-tools-standard-enterprise)."]]