MCP Reference: gmailmcp.googleapis.com

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.

MCP 도구

MCP 도구는 MCP 서버가 실제 세계에서 작업을 실행하기 위해 LLM 또는 AI 애플리케이션에 노출하는 함수 또는 실행 가능한 기능입니다.

gmailmcp.googleapis.com MCP 서버에는 다음과 같은 도구가 있습니다.

MCP 도구
create_draft

인증된 사용자의 Gmail 계정에 새 임시 이메일을 만듭니다.

이 도구는 수신자 주소, 제목, 본문 콘텐츠를 입력으로 사용합니다. 만들어진 Gmail 임시 이메일의 ID를 반환합니다.
list_drafts

인증된 사용자의 Gmail 계정에서 임시 이메일을 나열합니다.

이 도구는 쿼리 문자열을 기반으로 임시 이메일을 필터링할 수 있으며 페이지 나누기를 지원합니다. ID와 제목을 비롯한 임시 이메일 목록을 반환합니다.
get_thread 메일 목록을 비롯하여 인증된 사용자의 Gmail 계정에서 특정 이메일 스레드를 가져옵니다.
search_threads

인증된 사용자의 Gmail 계정에서 이메일 스레드를 나열합니다.

이 도구는 쿼리 문자열을 기반으로 스레드를 필터링할 수 있으며 페이지 나누기를 지원합니다. ID와 관련 메일을 비롯한 스레드 목록을 반환합니다. 각 관련 메일에는 메일 본문의 스니펫, 제목, 발신자, 수신자 등의 세부정보가 포함됩니다. 이 도구는 전체 메일 본문을 반환하지 않습니다. 필요한 경우 스레드 ID와 함께 'get_thread' 도구를 사용하여 전체 메일 본문을 가져오세요.
label_thread

인증된 사용자의 Gmail 계정에서 전체 스레드에 라벨을 추가합니다. 이 작업은 현재 스레드에 있는 모든 메일과 앞으로 추가될 메일에 영향을 미칩니다.

스레드 ID를 잘 모르는 경우 먼저 search_threads 도구를 사용하세요.

사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
unlabel_thread 인증된 사용자의 Gmail 계정에서 전체 스레드에서 라벨을 삭제합니다. 스레드 ID를 잘 모르는 경우 먼저 search_threads 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하세요.
list_labels 인증된 사용자의 Gmail 계정에서 사용 가능한 모든 사용자 정의 라벨을 나열합니다. `label_thread`, `unlabel_thread`, `label_message` 또는 `unlabel_message`를 호출하기 전에 이 도구를 사용하여 사용자 라벨의 `id`를 확인하세요. 시스템 라벨은 이 도구에서 반환되지 않지만 잘 알려진 ID('INBOX', 'TRASH', 'SPAM', 'STARRED', 'UNREAD', 'IMPORTANT', 'CHAT', 'DRAFT', 'SENT')와 함께 사용할 수 있습니다.
label_message

인증된 사용자의 Gmail 계정에서 특정 메일에 하나 이상의 라벨을 추가합니다.

메일 ID를 찾으려면 search_threads 또는 get_thread와 같은 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
unlabel_message 인증된 사용자의 Gmail 계정에서 특정 메일에서 하나 이상의 라벨을 삭제합니다. 메일 ID를 찾으려면 search_threads 또는 get_thread와 같은 도구를 사용하세요. 사용자 라벨의 ID를 잘 모르는 경우 먼저 list_labels 도구를 사용하여 사용 가능한 라벨과 ID를 확인하세요.
create_label 인증된 사용자의 Gmail 계정에 새 라벨을 만듭니다.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'