Contacts and Profile

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

Install

gcontacts is one plugin in the google-services-mcps marketplace, and it runs one MCP server with the same name. Install it for Claude Code with the command below. For Codex, OpenCode or Antigravity, change --agent; the product id stays the same.

Install for Claude Code

npx google-services-mcps install --agent claude --plugin gcontacts

What it manages

The server carries 4 generated API bindings and 2 gateway APIs. Gateway APIs are reached through api_search, api_describe and api_call, which every product with gateway APIs lists.

Generated API bindings
API	Version
dataportability	v1
health	v4
oauth2	v2
people	v1

Gateway APIs
API	Version
dataportability	v1beta
health	v4beta

Tools

The plugin's server registers 75 tools: 41 reads, 23 writes, 10 destructive actions and 1 dynamic tools. A read never asks. A write is listed only when Allow write tools is on, and asks before it runs. A destructive action asks twice. A dynamic tool decides per call.

Every tool name starts with mcp__plugin_gcontacts_gcontacts__, so a call traces back to this product. The table lists the tools this server registers, with the safety class from the plugin's tool map.

Registered tools
Tool	Class	What it does
account_remove	write	Remove a signed-in account
account_set_default	write	Set the default account
accounts_list	read	Signed-in accounts
api_call	dynamic	Call an API method
api_describe	read	Describe an API method
api_methods	read	gcontacts: API methods
api_search	read	Search API methods
auth_login	write	Sign in to Google
auth_setup_client	write	Save the Google OAuth client
auth_status	read	Sign-in status
contacts_delete	destructive	Delete a contact
contacts_list	read	List your contacts
contacts_search	read	Search your contacts
contacts_search_directory	read	Search the Workspace directory
data_archive_jobs_archive_state	read	dataportability.archiveJobs.getPortabilityArchiveState
dataportab_access_type_check	read	dataportability.accessType.check
dataportab_archive_initiate	write	dataportability.portabilityArchive.initiate
dataportab_archive_jobs_cancel	destructive	dataportability.archiveJobs.cancel
dataportab_archive_jobs_retry	write	dataportability.archiveJobs.retry
dataportab_authorization_reset	destructive	dataportability.authorization.reset
heal_points_export_exercise_tcx	read	health.users.dataTypes.dataPoints.exportExerciseTcx
health	read	Server health
health_data_types_points_create	write	health.users.dataTypes.dataPoints.create
health_data_types_points_get	read	health.users.dataTypes.dataPoints.get
health_data_types_points_list	read	health.users.dataTypes.dataPoints.list
health_data_types_points_patch	write	health.users.dataTypes.dataPoints.patch
health_paired_devices_list	read	health.users.pairedDevices.list
health_points_batch_delete	destructive	health.users.dataTypes.dataPoints.batchDelete
health_points_daily_roll_up	read	health.users.dataTypes.dataPoints.dailyRollUp
health_points_reconcile	read	health.users.dataTypes.dataPoints.reconcile
health_points_roll_up	read	health.users.dataTypes.dataPoints.rollUp
health_shl_m_get_shl_manifest	read	health.shl.m.getShlManifest
health_shl_r_get	read	health.shl.r.get
health_subscribers_create	write	health.projects.subscribers.create
health_subscribers_delete	destructive	health.projects.subscribers.delete
health_subscribers_list	read	health.projects.subscribers.list
health_subscribers_patch	write	health.projects.subscribers.patch
health_subscribers_subs_create	write	health.projects.subscribers.subscriptions.create
health_subscribers_subs_delete	destructive	health.projects.subscribers.subscriptions.delete
health_subscribers_subs_list	read	health.projects.subscribers.subscriptions.list
health_subscribers_subs_patch	write	health.projects.subscribers.subscriptions.patch
health_users_get_identity	read	health.users.getIdentity
health_users_get_irn_profile	read	health.users.getIrnProfile
health_users_get_profile	read	health.users.getProfile
health_users_get_settings	read	health.users.getSettings
health_users_paired_devices_get	read	health.users.pairedDevices.get
health_users_update_profile	write	health.users.updateProfile
health_users_update_settings	write	health.users.updateSettings
oauth2_userinfo_get	read	oauth2.userinfo.get
oauth2_userinfo_v2_me_get	read	oauth2.userinfo.v2.me.get
people_batch_create_contacts	write	people.people.batchCreateContacts
people_batch_delete_contacts	destructive	people.people.batchDeleteContacts
people_batch_update_contacts	write	people.people.batchUpdateContacts
people_contact_groups_batch_get	read	people.contactGroups.batchGet
people_contact_groups_create	write	people.contactGroups.create
people_contact_groups_delete	destructive	people.contactGroups.delete
people_contact_groups_get	read	people.contactGroups.get
people_contact_groups_list	read	people.contactGroups.list
people_contact_groups_update	write	people.contactGroups.update
people_contacts_contacts_group	write	people.otherContacts.copyOtherContactToMyContactsGroup
people_delete_contact_photo	destructive	people.people.deleteContactPhoto
people_groups_members_modify	write	people.contactGroups.members.modify
people_list_directory_people	read	people.people.listDirectoryPeople
people_other_contacts_list	read	people.otherContacts.list
people_other_contacts_search	read	people.otherContacts.search
people_people_connections_list	read	people.people.connections.list
people_people_create_contact	write	people.people.createContact
people_people_delete_contact	destructive	people.people.deleteContact
people_people_get	read	people.people.get
people_people_get_batch_get	read	people.people.getBatchGet
people_people_search_contacts	read	people.people.searchContacts
people_people_update_contact	write	people.people.updateContact
people_search_directory_people	read	people.people.searchDirectoryPeople
people_update_contact_photo	write	people.people.updateContactPhoto
profile_me	read	Your Google profile

The plugin option toolset can list fewer tools. google lists 3 tools that do the same jobs as Google's official MCP server for this product; curated lists the hand-written and gateway tools; all is the default.

gcontacts belongs to the workspace-user login group. Log in once for the group: create a Desktop OAuth client in a Google Cloud project, save its file with npx google-services-mcps setup-client, then run npx google-services-mcps login workspace-user. Products in this group share the one login.

The plugin's scope file lists 107 OAuth scopes for 1 APIs. A login asks only for the scopes of its profile: readonly (the default), readwrite, full, or an exact list.

OAuth scopes in the plugin's scope file
API	Scope
gcontacts	https://www.googleapis.com/auth/cloud-platform
gcontacts	https://www.googleapis.com/auth/contacts
gcontacts	https://www.googleapis.com/auth/contacts.other.readonly
gcontacts	https://www.googleapis.com/auth/contacts.readonly
gcontacts	https://www.googleapis.com/auth/dataportability.alerts.subscriptions
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.autofill
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.bookmarks
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.dictionary
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.extensions
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.history
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.reading_list
gcontacts	https://www.googleapis.com/auth/dataportability.chrome.settings
gcontacts	https://www.googleapis.com/auth/dataportability.discover.follows
gcontacts	https://www.googleapis.com/auth/dataportability.discover.likes
gcontacts	https://www.googleapis.com/auth/dataportability.discover.not_interested
gcontacts	https://www.googleapis.com/auth/dataportability.maps.aliased_places
gcontacts	https://www.googleapis.com/auth/dataportability.maps.commute_routes
gcontacts	https://www.googleapis.com/auth/dataportability.maps.commute_settings
gcontacts	https://www.googleapis.com/auth/dataportability.maps.ev_profile
gcontacts	https://www.googleapis.com/auth/dataportability.maps.factual_contributions
gcontacts	https://www.googleapis.com/auth/dataportability.maps.offering_contributions
gcontacts	https://www.googleapis.com/auth/dataportability.maps.photos_videos
gcontacts	https://www.googleapis.com/auth/dataportability.maps.questions_answers
gcontacts	https://www.googleapis.com/auth/dataportability.maps.reviews
gcontacts	https://www.googleapis.com/auth/dataportability.maps.starred_places
gcontacts	https://www.googleapis.com/auth/dataportability.maps.vehicle_profile
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.maps
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.myadcenter
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.play
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.search
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.shopping
gcontacts	https://www.googleapis.com/auth/dataportability.myactivity.youtube
gcontacts	https://www.googleapis.com/auth/dataportability.mymaps.maps
gcontacts	https://www.googleapis.com/auth/dataportability.nest.camera_event
gcontacts	https://www.googleapis.com/auth/dataportability.nest.camera_feature
gcontacts	https://www.googleapis.com/auth/dataportability.nest.camera_video
gcontacts	https://www.googleapis.com/auth/dataportability.nest.store
gcontacts	https://www.googleapis.com/auth/dataportability.nest.user
gcontacts	https://www.googleapis.com/auth/dataportability.order_reserve.purchases_reservations
gcontacts	https://www.googleapis.com/auth/dataportability.pixel.device_data
gcontacts	https://www.googleapis.com/auth/dataportability.play.devices
gcontacts	https://www.googleapis.com/auth/dataportability.play.grouping
gcontacts	https://www.googleapis.com/auth/dataportability.play.installs
gcontacts	https://www.googleapis.com/auth/dataportability.play.library
gcontacts	https://www.googleapis.com/auth/dataportability.play.playpoints
gcontacts	https://www.googleapis.com/auth/dataportability.play.promotions
gcontacts	https://www.googleapis.com/auth/dataportability.play.purchases
gcontacts	https://www.googleapis.com/auth/dataportability.play.redemptions
gcontacts	https://www.googleapis.com/auth/dataportability.play.subscriptions
gcontacts	https://www.googleapis.com/auth/dataportability.play.usersettings
gcontacts	https://www.googleapis.com/auth/dataportability.saved.collections
gcontacts	https://www.googleapis.com/auth/dataportability.search_ugc.comments
gcontacts	https://www.googleapis.com/auth/dataportability.search_ugc.media.reviews_and_stars
gcontacts	https://www.googleapis.com/auth/dataportability.search_ugc.media.streaming_video_providers
gcontacts	https://www.googleapis.com/auth/dataportability.search_ugc.media.thumbs
gcontacts	https://www.googleapis.com/auth/dataportability.search_ugc.media.watched
gcontacts	https://www.googleapis.com/auth/dataportability.searchnotifications.settings
gcontacts	https://www.googleapis.com/auth/dataportability.searchnotifications.subscriptions
gcontacts	https://www.googleapis.com/auth/dataportability.shopping.addresses
gcontacts	https://www.googleapis.com/auth/dataportability.shopping.reviews
gcontacts	https://www.googleapis.com/auth/dataportability.streetview.imagery
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.channel
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.clips
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.comments
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.conversations
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.live_chat
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.music
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.playable
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.posts
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.private_playlists
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.private_videos
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.public_playlists
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.public_videos
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.shopping
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.subscriptions
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.unlisted_playlists
gcontacts	https://www.googleapis.com/auth/dataportability.youtube.unlisted_videos
gcontacts	https://www.googleapis.com/auth/directory.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.ecg.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.health_metrics_and_measurements.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.irn.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.location.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.logged_symptoms.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.logged_symptoms.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.mindfulness.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.mindfulness.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.nutrition.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.profile.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.profile.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.reproductive_health.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.reproductive_health.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.settings.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.settings.writeonly
gcontacts	https://www.googleapis.com/auth/googlehealth.sleep.readonly
gcontacts	https://www.googleapis.com/auth/googlehealth.sleep.writeonly
gcontacts	https://www.googleapis.com/auth/user.addresses.read
gcontacts	https://www.googleapis.com/auth/user.birthday.read
gcontacts	https://www.googleapis.com/auth/user.emails.read
gcontacts	https://www.googleapis.com/auth/user.gender.read
gcontacts	https://www.googleapis.com/auth/user.organization.read
gcontacts	https://www.googleapis.com/auth/user.phonenumbers.read
gcontacts	https://www.googleapis.com/auth/userinfo.email
gcontacts	https://www.googleapis.com/auth/userinfo.profile
gcontacts	openid

Plugin details

Plugin: gcontacts
MCP server: gcontacts
Display name: Contacts and Profile
Version: 2.17.0
Marketplace: google-services-mcps
Login group: workspace-user
Marketplace category: productivity
Plugin options: allow_writes, confirmation, token_dir, toolset
Server kind: curated+discovery

Install

What it manages

Tools

Sign-in

Plugin details

Related