bldinit Google People Rest API

The google_people-rest API from bldinit — 4 operation(s) for google_people-rest.

GitHub OpenAPI

Operations 4

GET /api/v1/google_people/v1/people/me/connections 내 Google 연락처(My Contacts) 목록 조회 #
GET /api/v1/google_people/v1/people/{resourceName} 특정 연락처(Person) 단건 상세 조회 #
GET /api/v1/google_people/v1/people:searchContacts Google 연락처 검색 (이름·이메일·전화번호·조직 prefix 매칭) #
GET /api/v1/google_people/v1/otherContacts 기타 연락처(Other Contacts) 목록 — Gmail·Calendar 상호작용 자동 생성 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-people-rest-api"
All apis
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.

Get an API 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 Specification

mcpweave-com-google-people-rest-api-openapi.yml Raw ↑
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)