How to connect Google Admin to Claude

Connect Claude Web, Desktop and Cowork to Google Admin MCP. Add new employee to all-staff group, list all users in marketing department, and more using natural language, with authentication handled for you.

Google Admin logoGoogle Admin
Oauth2

Google Admin is the central console for managing Google Workspace users, groups, and organizational units. It streamlines organizational control, saving admins time and reducing errors.

14 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Google Admin account to Claude via Composio Connect, enabling it to add new employee to all-staff group, list all users in marketing department, create a group for project leads, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Google Admin with

Connecting Google Admin to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Google Admin account

Back in Claude, ask it to connect to Google Admin or give it any Google Admin-related task.

For example, ask Claude to:

  • "Add new employee to all-staff group"
  • "List all users in marketing department"
  • "Create a group for project leads"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Google Admin account is ready to use.

What is the Google Admin Claude Connector, and what's possible with it?

The Google Admin MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Admin account. It provides structured and secure access to your organization's Google Workspace admin console, so your agent can manage users, groups, aliases, and organizational units on your behalf.

  • Automated user management: Easily create, update, or delete Google Workspace user accounts, letting your agent handle onboarding, offboarding, and user details with precision.
  • Group administration and membership control: Have your agent create groups, list all group members, add or remove users from groups, and fetch group details to streamline team management.
  • Email alias assignment: Direct your agent to add email aliases to user accounts, simplifying communication and identity management for your organization.
  • Comprehensive user and group directory access: Ask your agent to list all users or groups in your domain, filter them as needed, and retrieve detailed information to support audits or directory syncs.
  • Secure and efficient admin operations: Let your agent perform sensitive admin actions like deleting users or managing group settings—always with proper access controls and auditability.

Troubleshooting

1. Why does Claude not use the Composio connector for Google Admin?

The connector can show as connected, but Claude must use it in each Google Admin conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Google Admin again.

2. Why does Claude show an MCP server error before Google Admin connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Google Admin.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Google Admin.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Google Admin authorization link not work?

The Composio connector is one server. Your Google Admin account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Google Admin connection.
  • Composio creates a fresh Google Admin authorization link.
  • Open that link in your browser and finish the Google Admin sign-in.

4. Why do Google Admin actions fail after they worked before?

The Google Admin connection can expire or lose permission.

  • Ask Claude to inspect the Google Admin connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Google Admin account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Google Admin.
  • If the action still fails with a permission error, check that the connected account has that permission in Google Admin itself.

5. How do I switch to a different Google Admin account?

Claude can manage the Google Admin connection for you.

  • Ask Claude to disconnect or delete the current Google Admin account.
  • Ask Claude to connect Google Admin again.
  • Open the new Composio authorization link for Google Admin.
  • Sign in with the other Google Admin account in the browser.
  • After the account connects, ask Claude to retry the Google Admin task.

6. Why is my Google Admin connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Google Admin connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Google Admin tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Google Admin.
TOOLS

Supported Tools

Every Google Admin action and event your agent gets out of the box.

Add Alias to Google Workspace User

Adds an email alias to a Google Workspace user.

Add User to Google Workspace Group

Adds a user to a Google Workspace group with the specified role.

Create Google Workspace Group

Creates a new Google Workspace group with the specified details.

Create Google Workspace User

Creates a new Google Workspace user with the specified details.

Delete Google Workspace User

Deletes a Google Workspace user permanently.

Get Google Workspace Group Details

Retrieves detailed information about a Google Workspace group.

Get Google Workspace User Details

Retrieves detailed information about a Google Workspace user.

List Google Workspace Group Members

Lists all members of a Google Workspace group with optional filtering and pagination.

List Google Workspace Groups

Lists Google Workspace groups with optional filtering and pagination.

List Google Workspace Users

Lists Google Workspace users with optional filtering and pagination.

Remove Alias from Google Workspace User

Removes an email alias from a Google Workspace user.

Remove User from Google Workspace Group

Removes a user from a Google Workspace group, revoking their group access.

Suspend/Unsuspend Google Workspace User

Suspends or unsuspends a Google Workspace user account.

Update Google Workspace Group Settings

Updates settings for a Google Workspace group.

FAQ

Frequently asked questions

With a standalone Google Admin MCP server, the agents and LLMs can only access a fixed set of Google Admin tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google Admin and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google Admin tools.

Yes, absolutely. You can configure which Google Admin scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google Admin data and credentials are handled as safely as possible.

Start with Google Admin.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google Admin tool your agent needs.Free to start.

Start building