bldinit Google People Rest API
The google_people-rest API from bldinit — 4 operation(s) for google_people-rest.
The google_people-rest API from bldinit — 4 operation(s) for google_people-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-people-rest-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: mcpweave Google People Rest API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: google_people-rest
paths:
/api/v1/google_people/v1/people/me/connections:
get:
tags:
- google_people-rest
summary: 내 Google 연락처(My Contacts) 목록 조회
description: '인증된 사용자의 Google 주소록(My Contacts)에서 연락처 목록을 반환합니다.
sync token 기반 증분 동기화 지원(sync token 유효기간 7일).
⚠️ **연락처 데이터는 PII입니다.** MCP 경로에서는 이름·이메일·전화번호·주소가
ADR-083/088 chokepoint에서 자동 redact됩니다(의도된 동작).
**사전 준비**:
1. GCP Console에서 ``People API`` 활성화 필수 (people.googleapis.com).
2. 자기 GCP OAuth 앱에 ``contacts.readonly`` 스코프 동의.
**personFields (필수)** — 반환할 Person 필드 쉼표 구분 목록. 미지정 시 400 에러.
자주 쓰는 값:
- ``names`` — 이름 (displayName, familyName, givenName)
- ``emailAddresses`` — 이메일
- ``phoneNumbers`` — 전화번호
- ``organizations`` — 회사·직책
- ``addresses`` — 주소
- ``birthdays`` — 생일
- ``photos`` — 프로필 사진 (output only)
- ``memberships`` — 연락처 그룹
- ``metadata`` — 메타데이터
예: ``"names,emailAddresses,phoneNumbers,organizations"``
**응답 주요 필드**: connections[] / nextPageToken / nextSyncToken / totalItems.
각 연락처: resourceName("people/c{id}") / etag / names[] / emailAddresses[] /
phoneNumbers[] / organizations[] / addresses[].
**페이지네이션**: nextPageToken → 다음 pageToken 파라미터.
syncToken 사용 시 삭제된 연락처는 PersonMetadata.deleted=true 로 반환.
Native pass-through.'
operationId: google_people_list_connections
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: personFields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Personfields
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: sortOrder
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Sortorder
- name: syncToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Synctoken
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_people/v1/people/{resourceName}:
get:
tags:
- google_people-rest
summary: 특정 연락처(Person) 단건 상세 조회
description: 'resourceName 으로 특정 연락처를 단건 조회합니다.
``people/me`` 지정 시 인증된 사용자 자신의 프로필을 반환합니다.
⚠️ **연락처 데이터는 PII입니다.** MCP 경로에서는 이름·이메일·전화번호·주소가
ADR-083/088 chokepoint에서 자동 redact됩니다(의도된 동작).
**resourceName 형식** — ``people/`` 접두 없이 **뒷부분만** 넣습니다(게이트웨이가 경로에 자동으로 붙임):
- ``me`` — 자신의 프로필 (people/me)
- ``c{id}`` — 특정 연락처. list_connections / search_contacts 응답의
resourceName(``people/c123``)에서 ``people/`` 뒤 부분(``c123``)만 사용 (예: ``c1234567890``).
**personFields (필수)** — 반환할 Person 필드 쉼표 구분 목록. 미지정 시 400 에러.
자주 쓰는 값: ``names,emailAddresses,phoneNumbers,organizations,addresses,birthdays``
**응답**: Person 단일 객체 (wrapper 없음).
resourceName / etag / names[] / emailAddresses[] / phoneNumbers[] / organizations[] /
addresses[] / birthdays[] / photos[] / memberships[].
Native pass-through.'
operationId: google_people_get_person
parameters:
- name: resourceName
in: path
required: true
schema:
type: string
title: Resourcename
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: personFields
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Personfields
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_people/v1/people:searchContacts:
get:
tags:
- google_people-rest
summary: Google 연락처 검색 (이름·이메일·전화번호·조직 prefix 매칭)
description: '인증된 사용자의 My Contacts 그룹에서 쿼리 문자열로 연락처를 검색합니다.
이름·닉네임·이메일·전화번호·조직명에서 prefix 매칭.
최대 30건 반환 (30건 초과 요청 시 30으로 cap).
페이지네이션 없음 — 30건 이상 필요 시 list_connections 사용 후 클라이언트 필터링 권장.
⚠️ **연락처 데이터는 PII입니다.** MCP 경로에서는 이름·이메일·전화번호·주소가
ADR-083/088 chokepoint에서 자동 redact됩니다(의도된 동작).
**공식 doc 권고**: 첫 검색 전 ``query=""`` (빈 문자열) 로 warmup 요청 권장
(캐시 갱신 목적 — 응답 results:[] 정상).
**query 매칭 방식**:
- prefix 매칭: ``query="홍"`` → "홍길동", "홍범도" 매칭
- 공백 포함: ``query="홍 길"`` → "홍 길동" 매칭
- 중간 문자열 불가: ``query="길동"`` → "홍길동" **불매칭**
**readMask (필수)** — 반환할 Person 필드 쉼표 구분 목록. 미지정 시 400 에러.
자주 쓰는 값: ``names,emailAddresses,phoneNumbers,organizations``
**응답**: SearchResponse — results[] 배열. 각 항목: results[].person (Person 객체).
Native pass-through.'
operationId: google_people_search_contacts
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: query
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Query
- name: readMask
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Readmask
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
/api/v1/google_people/v1/otherContacts:
get:
tags:
- google_people-rest
summary: 기타 연락처(Other Contacts) 목록 — Gmail·Calendar 상호작용 자동 생성
description: '"기타 연락처(Other contacts)" 목록을 반환합니다.
Other contacts 는 Gmail 이메일 수발신·Google Calendar 초대 등 Google 서비스
상호작용에서 자동 생성된 연락처이며 My Contacts 그룹에 속하지 않습니다.
sync token 기반 증분 동기화 지원 (sync token 유효기간 7일).
**scope 주의**: ``contacts.other.readonly`` 전용 scope 필요.
``contacts.readonly`` 만으로는 이 엔드포인트에 접근 불가.
mcpweave google_people 연결 시 두 scope 모두 동의합니다.
⚠️ **연락처 데이터는 PII입니다.** MCP 경로에서는 이름·이메일·전화번호·주소가
ADR-083/088 chokepoint에서 자동 redact됩니다(의도된 동작).
**resourceName 형식**: ``otherContacts/c{id}`` (my contacts 의 ``people/c{id}`` 와 다름).
**readMask (필수)** — 반환할 Person 필드 쉼표 구분 목록. 미지정 시 400 에러.
기본 소스(READ_SOURCE_TYPE_CONTACT) 기준 유효값:
``emailAddresses, metadata, names, phoneNumbers, photos``
주의: ``organizations`` 등 확장 필드는 기본 소스에서 반환되지 않을 수 있음.
**응답 주요 필드**: otherContacts[] / nextPageToken / nextSyncToken / totalSize.
Native pass-through.'
operationId: google_people_list_other_contacts
parameters:
- name: connection_id
in: query
required: true
schema:
type: string
description: mcpweave connection_id
title: Connection Id
description: mcpweave connection_id
- name: readMask
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Readmask
- name: pageSize
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagesize
- name: pageToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Pagetoken
- name: syncToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Synctoken
- name: X-API-Key
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Key
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
default:
description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)