문서로 건너뛰기
MCP 서버

설명

스레드에 붙여 두는 개인 메모.

메모 도구

도구하는 일
listThreadNotes스레드의 메모. 고정된 메모가 먼저이며, 각각 다른 메모 도구가 받는 id가 있습니다.
addThreadNote앱이 제공하는 여덟 가지 색 중 하나로 스레드에 메모를 붙입니다. 다른 메모 뒤에 붙고, 고정된 메모는 맨 위에 남습니다.
updateThreadNote메모의 내용, 색, 고정 여부를 바꿉니다.
deleteThreadNote메모를 완전히 삭제합니다. 메모에는 휴지통이 없습니다.
reorderThreadNotes스레드의 메모를 모두 지정해 처음부터 끝까지 순서를 정합니다.

메모는 작성한 사람의 것이므로, 이 도구들은 클라이언트를 연결한 사람의 메모를 읽고 씁니다. 읽기에는 threads:read, 변경에는 threads:write가 필요하며, 일부 주소로 제한된 클라이언트는 그곳으로 들어온 스레드에만 닿습니다.

앱 채팅에서는 메모 추가, 변경, 삭제, 정렬을 직접 요청하지 않았다면 먼저 묻습니다.

레퍼런스

listThreadNotes

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷notes

The private notes on one email thread, pinned ones first, each with the id the other note tools take. Notes belong to the person who wrote them, so this is that person's view.

입력

threadIdstring필수
비어 있지 않음

다른 사용처

API
GET /threads/{id}/notes
SDK
threads.listNotes()

addThreadNote

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷notes

Pin a private note to an email thread, as the Notes panel does. It goes after the other notes, and pinned keeps it at the top. color is one of the eight the app offers.

입력

threadIdstring필수
비어 있지 않음
contentstring필수
1~20000자
colorstring
다음 중 하나"default""red""orange""yellow""green""blue""purple""pink"
pinnedboolean

다른 사용처

API
POST /threads/{id}/notes
SDK
threads.createNote()

updateThreadNote

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷notes

Change a note on a thread: its text, its colour or whether it is pinned. Give at least one. Take the note id from listThreadNotes.

입력

threadIdstring필수
비어 있지 않음
noteIdstring필수
1~64자
contentstring
1~20000자
colorstring
다음 중 하나"default""red""orange""yellow""green""blue""purple""pink"
pinnedboolean

다른 사용처

API
PATCH /threads/{id}/notes/{noteId}
SDK
threads.updateNote()

deleteThreadNote

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷notes

Delete a note from a thread for good. There is no bin for notes. Take the note id from listThreadNotes.

입력

threadIdstring필수
비어 있지 않음
noteIdstring필수
1~64자

다른 사용처

API
DELETE /threads/{id}/notes/{noteId}
SDK
threads.deleteNote()

reorderThreadNotes

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷notes

Arrange the notes on a thread, first to last. noteIds has to name every note on the thread exactly once; pinned notes still come first.

입력

threadIdstring필수
비어 있지 않음
noteIdsstring[]필수
1~200개 항목

다른 사용처

API
POST /threads/{id}/notes/reorder
SDK
threads.reorderNotes()