GSuite

MCP server to interact with Google produts.

To install G Suite Integration for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude

- Go to theGoogle Cloud Console
- Create a new project or select an existing one
- Enable the Gmail API and Google Calendar API for your project
- Go to "Credentials" → "Create Credentials" → "OAuth client ID"
- Select "Desktop app" or "Web application" as the application type
- Configure the OAuth consent screen with required information
- Add authorized redirect URIs (includehttp://localhost:4100/codefor local development)

[ "openid", "https://mail.google.com/", "https://www.googleapis.com/auth/calendar", "https://www.googleapis.com/auth/userinfo.email" ]

- Then create a.gauth.jsonin your working directory with client

{ "web": { "client_id": "$your_client_id", "client_secret": "$your_client_secret", "redirect_uris": ["http://localhost:4100/code"], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://oauth2.googleapis.com/token" } }

- Create a.accounts.jsonfile with account information

{ "accounts": [ { "email": "alice@bob.com", "account_type": "personal", "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'" } ] }

You can specifiy multiple accounts. Make sure they have access in your Google Auth app. Theextra_infofield is especially interesting as you can add info here that you want to tell the AI about the account (e.g. whether it has a specific agenda)

Note: When you first execute one of the tools for a specific account, a browser will open, redirect you to Google and ask for your credentials, scope, etc. After a successful login, it stores the credentials in a local file called.oauth.{email}.json. Once you are authorized, the refresh token will be used.

On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mcp-gsuite": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-gsuite", "run", "mcp-gsuite" ] } } }

{ "mcpServers": { "mcp-gsuite": { "command": "uvx", "args": [ "mcp-gsuite" ] } } }

The MCP server can be configured with several command-line options to specify custom paths for authentication and account information:

- --gauth-file: Specifies the path to the.gauth.jsonfile containing OAuth2 client configuration. Default is./.gauth.json.
- --accounts-file: Specifies the path to the.accounts.jsonfile containing information about the Google accounts. Default is./.accounts.json.
- --credentials-dir: Specifies the directory where OAuth credentials are stored after successful authentication. Default is the current working directory with a subdirectory for each account as.oauth.{email}.json.

These options allow for flexibility in managing different environments or multiple sets of credentials and accounts, especially useful in development and testing scenarios.

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

This configuration is particularly useful when you have multiple instances of the server running with different configurations or when deploying to environments where the default paths are not suitable.

To prepare the package for distribution:

This will create source and wheel distributions in thedist/directory.

Note: You'll need to set PyPI credentials via environment variables or command flags:

- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.

You can launch the MCP Inspector vianpmwith this command:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log

Provides various DingTalk services including contacts, department management, robot messaging, calendar, and tasks.