Google MCP servers for Codex

The suite is 23 MCP servers for Google products, one plugin per product, and the same servers run in Codex. This page covers the install command for Codex, where it writes, and what Codex does and does not do about approvals.

Install a product for Codex

Every product uses the same command. Change the product id to install another one, or pass --plugin all to install every product at once.

npx google-services-mcps install --agent codex --plugin gmail

The installer copies each product's server files to ~/.google-services-mcps/runtime/<product>/ and writes one entry per server into a block of config.toml that it owns, between marker lines. Text outside the block is never changed.

The default scope is global, which is your account. The installer writes ~/.codex/config.toml for the global scope, and .codex/config.toml in a folder for the project and local scopes. Add --dry-run to see every change without writing one.

Where it writes

Approvals in Codex

Codex has no consent hook in this suite. A client that cannot ask for approval is refused every change, so nothing runs without a confirmation.

Reads never ask. A write is listed only when Allow write tools is on, and a destructive action asks twice in Claude Code. The full consent model is on the architecture page.

What you need

Codex, and Node.js 20 or newer. Codex reads a project config.toml only in a trusted project, so trust the folder or its servers stay off.

The 23 products

Each product is one plugin and one MCP server. The list is generated from the plugin folders at build time; every product page shows the tools that server registers.

• Workspace Admin

  gadmin

  Google Workspace administration: Cloud Identity, Chrome management and policy, Groups Settings, licensing, reports, alerts, Vault, reseller and Cloud Search admin.

  368 tools · workspace-admin login

• Ads and Publisher

  gads

  Google Ads API (accounts, campaigns, ad groups, ads, keywords, budgets, conversions, assets and GAQL reporting, with every other method through the gateway), plus advertising and publisher APIs: Search Ads 360, Display & Video 360, Campaign Manager, Ad Exchange, AdSense, AdMob, Real-time Bidding and more.

  338 tools · business login

• AI and ML

  gai

  Generative and classic AI APIs: Discovery Engine, Vertex AI, Dialogflow, Vision, Speech, Translate, Document AI and agent services.

  364 tools · cloud login

• Google Analytics

  ganalytics

  Google Analytics admin and data APIs for GA4 properties, configuration and reports.

  83 tools · business login

• Apps Script

  gapps

  Apps Script projects and execution, plus the Workspace Marketplace SDK.

  26 tools · workspace-user login

• Business Profile

  gbusiness

  Business Profile accounts, locations, verifications, lodging, place actions, notifications and performance.

  59 tools · business login

• Google Calendar

  gcalendar

  Google Calendar calendars, events and calendar settings.

  55 tools · workspace-user login

• Google Chat

  gchat

  Google Chat spaces, messages and members, plus Workspace Events subscriptions.

  78 tools · workspace-user login

• Google Classroom

  gclassroom

  Google Classroom courses, coursework, submissions, students and teachers.

  129 tools · workspace-user login

• Google Cloud

  gcloud

  Google Cloud console APIs: projects, service enablement, API keys, billing, monitoring, storage, BigQuery and IAM, plus the rest of the infrastructure, data, devops, networking, security and governance APIs.

  393 tools · cloud login

• Contacts and Profile

  gcontacts

  Google Contacts and People, personal health metrics, Data Portability, and the OAuth2 userinfo endpoints.

  75 tools · workspace-user login

• Google Drive and Docs

  gdrive

  Google Drive files, labels and activity, plus Docs, Sheets, Slides, Forms and Books.

  200 tools · workspace-user login

• Firebase

  gfirebase

  Firebase management, App Check, App Distribution, Crashlytics, Hosting, Data Connect, Rules, Test Lab, FCM and Identity Toolkit.

  315 tools · developer login

• Gmail

  gmail

  Gmail mailboxes, messages, labels and settings, plus Gmail Postmaster Tools.

  114 tools · workspace-user login

• Maps and Location

  gmaps

  Maps Platform and location APIs: Places, Address Validation, Solar, Air Quality, Pollen, Street View Publish and related datasets.

  39 tools · apikey login

• Google Meet

  gmeet

  Google Meet spaces, conference records, participants and recordings.

  34 tools · workspace-user login

• Merchant Center

  gmerchant

  Merchant Center: Merchant API and Comparison Shopping Service, through a service account key.

  153 tools · service-account login

• Google Play

  gplay

  Google Play developer publishing and reporting, Play Games Services, Android Enterprise and Management, Play Integrity and device APIs.

  366 tools · service-account login

• Search Console

  gsc

  Search Console sites, sitemaps, search analytics, URL indexing and site verification.

  37 tools · searchconsole login

• Search and Web Quality

  gsearch

  Public search and web-quality APIs (Custom Search, PageSpeed, CrUX, Safe Browsing, Web Risk, Fact Check) that take an API key instead of OAuth. The Custom Search JSON API is closed to new customers and is scheduled to be discontinued on 2027-01-01.

  53 tools · apikey login

• Tasks and Keep

  gtasks

  Google Tasks task lists and tasks, plus Google Keep notes.

  29 tools · workspace-user login

• Tag Manager

  gtm

  Google Tag Manager accounts, containers, tags, triggers and variables.

  118 tools · business login

• YouTube and Blogger

  gyoutube

  YouTube Data, YouTube Analytics and YouTube Reporting APIs, plus Blogger.

  132 tools · business login

Keeping it current

Run the install again after a new release, so the runtime copy and the config entry are refreshed.

Related

• Install: every route, flag and scope, for all four harnesses
• Products: all 23 products, with their tools and login groups
• Architecture: the marketplace, the plugin and the server
• Configuration: the plugin options, the environment variables and the policy file
• Troubleshooting: what to check when a server does not load