Notion
NotionDocs & Knowledge
Pages, blocks, databases, views, comments and files — search, read, write, edit and trash (full Notion API)
Available tools 41
Hard-to-undo tools, such as sending or destructive actions, require your approval before running.
- notion__delete_commentDestructiveApproval required
이 연결이 남긴 댓글 하나를 지운다(남의 댓글은 404 로 실패한다). ⚠️ 되돌릴 수 없다. 내용만 고치려면 notion__update_comment. comment_id 는 notion__list_comments 결과의 id. 결과: deleted · comment_id.
- notion__delete_viewDestructiveApproval required
데이터베이스 보기(표·보드 등) 삭제 — 행(데이터)은 그대로다. ⚠️ 보기 설정(필터·정렬·열 배치)은 되돌릴 수 없다 — 다시 만들려면 notion__create_view. 마지막 남은 보기는 지울 수 없다. view_id 는 notion__list_views 결과의 view_id. 결과: deleted · view_id.
- notion__replace_page_contentDestructiveApproval required
페이지 본문 전체를 새 마크다운(content, Notion 마크다운 표기) 또는 템플릿(template_id)으로 갈아 끼운다. ⚠️ 이전 본문이 통째로 사라지고 이 커넥터로는 되돌릴 수 없다(Notion 페이지 기록에서만 복원). 일부만 고칠 때는 notion__edit_page, 끝에 덧붙일 때는 notion__append. content 를 빈 문자열로 주면 본문이 빈다. page_id 는 notion__search 결과의 id, template_id 는 notion__list_templates 결과의 template_id. 결과: replaced · page_id · warnings.
- notion__trashDestructiveApproval required
페이지·블록·데이터베이스를 Notion 휴지통으로 옮긴다(Notion 의 삭제) — page_id · block_id · database_id 중 정확히 하나, 하위 페이지·블록도 함께 간다. ⚠️ notion__restore 나 Notion 휴지통에서 되살릴 수 있다 — 휴지통 항목은 notion__search 에 안 나오니 지운 id 를 기억해 둔다. 본문 일부만 바꾸려면 notion__edit_page. page_id 는 notion__search 결과의 id, database_id 는 notion__get_database 결과의 database_id. 결과: trashed · 지운 대상 id · note.
- notion__update_data_sourceDestructiveApproval required
데이터베이스 구조(속성=열)를 바꾼다 — 추가·이름 바꾸기·타입·선택지 변경·삭제(null), data source 제목. ⚠️ 모든 행에 적용되고, 속성을 지우거나 타입을 바꾸면 그 열의 값이 사라져 되돌릴 수 없다. 제목·설명·아이콘만 바꾸려면 notion__update_database. 지금 속성은 notion__get_database 로 먼저 본다. data_source_id 는 notion__get_database 결과의 data_sources[].data_source_id — data source 가 여럿인데 database_id 만 주면 목록과 함께 실패한다. 결과: updated · data_source_id · title · properties.
- notion__create_commentSendApproval required
Notion 페이지·블록에 새 댓글을 달거나 토론에 답글을 단다 — page_id · block_id · discussion_id 중 정확히 하나. ⚠️ 페이지를 보는 사람에게 보이고 알림이 간다 — 알림은 되돌릴 수 없지만 댓글은 notion__update_comment 로 고치고 notion__delete_comment 로 지울 수 있다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). page_id 는 notion__search 결과의 id, discussion_id 는 notion__list_comments 결과. 결과: created · comment_id · discussion_id.
- notion__update_commentSendApproval required
이 연결이 남긴 댓글의 내용을 새 내용으로 바꾼다(남의 댓글은 404 로 실패한다). ⚠️ 바뀐 내용이 페이지를 보는 사람에게 바로 보이고 이전 내용은 되돌릴 수 없다 — 다시 고쳐 쓰는 수밖에 없다. 요청에 새 내용이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). comment_id 는 notion__list_comments 결과의 id. 결과: updated · id · discussion_id · text.
- notion__appendWrite
페이지(또는 블록) 안에 내용 추가 — 기본은 끝에, after_block_id 를 주면 그 블록 바로 뒤에, position=start 면 맨 앞에. ⚠️ 사용자의 문서를 실제로 수정한다 — 요청에 없는 페이지 · 내용이면 먼저 확인받을 것
- notion__create_data_sourceWrite
기존 데이터베이스에 data source(별도 표) 추가 — 속성 표기는 notion__create_database 와 같다
- notion__create_databaseWrite
페이지 안에 새 데이터베이스 생성 — 속성은 간단 표기 {"상태": {"status": []}, "태그": {"multi_select": ["a","b"]}, "점수": "number", "마감": "date"}. 제목 속성이 없으면 「이름」 을 넣는다. ⚠️ 사용자의 워크스페이스에 실제로 데이터베이스가 생긴다 — 위치 · 구조가 요청에 없으면 먼저 확인받을 것
- notion__create_meeting_notesWrite
Notion AI 회의록 만들기 — 올린 녹음 파일(notion__upload_file 의 file_upload_id)을 페이지에 넣거나 이미 있는 오디오 블록으로. Notion AI 가 몇 분 뒤 요약한다(Notion AI 가 있는 워크스페이스만)
- notion__create_pageWrite
새 페이지 생성 — 부모는 parent_page_id · parent_data_source_id · parent_database_id 중 하나만. 데이터베이스 아래면 행이 되고 properties 로 속성을 채운다. 본문은 마크다운. ⚠️ 사용자의 워크스페이스에 실제로 문서가 생긴다 — 위치 · 제목이 요청에 없으면 먼저 확인받을 것
- notion__create_viewWrite
데이터베이스에 보기 추가(database_id) 또는 페이지에 연결된 데이터베이스 보기 블록 생성(page_id + data_source_id). 보드는 configuration.group_by, 캘린더는 date_property_id 가 필요하다
- notion__edit_pageWrite
페이지 본문 찾아 바꾸기 — 찾을 글(old_str)은 notion__get_page_markdown 결과에서 그대로 복사하고, 새 글은 같은 Notion 마크다운 표기로. 여러 곳을 한 번에(edits, 100개까지). 하위 페이지·DB 는 지우지 못한다. ⚠️ 사용자의 문서를 실제로 수정한다 — 요청에 없는 페이지 · 내용이면 먼저 확인받을 것
- notion__move_pageWrite
페이지를 다른 페이지 또는 데이터베이스 아래로 옮긴다 — 부모는 셋 중 하나. ⚠️ 옮긴 곳의 공유 범위를 따르므로 보는 사람이 바뀔 수 있다 — 옮길 곳이 요청에 없으면 먼저 확인받을 것
- notion__restoreWrite
notion__trash 로 휴지통에 옮긴 페이지·블록·데이터베이스를 되살린다 — 지울 때 쓴 id 를 그대로 준다(휴지통 항목은 notion__search 에 안 나온다). 결과: restored · 되살린 대상 id.
- notion__update_blockWrite
블록 하나 수정 — 글자(마크다운 인라인 서식)·할 일 체크·코드 언어, 또는 block 에 그 종류의 설정을 직접. 블록 종류는 바꿀 수 없다. ⚠️ 사용자의 문서를 실제로 수정한다 — 요청에 없는 페이지 · 내용이면 먼저 확인받을 것
- notion__update_databaseWrite
데이터베이스 제목·설명·아이콘·커버·인라인 여부·잠금 수정, 다른 페이지로 이동. 속성(열) 구조는 notion__update_data_source
- notion__update_pageWrite
페이지 속성·아이콘·커버·잠금 수정, 템플릿 적용 — 데이터베이스 행의 상태·날짜·담당자 등을 바꿀 때. 속성 값은 notion__create_page 의 properties 와 같은 간단 표기. 본문은 notion__append·notion__update_block
- notion__update_viewWrite
보기 이름·필터·정렬·구성 수정 — clear_filter·clear_sorts 로 지운다
- notion__upload_fileWrite
파일을 Notion 에 올리고 바로 붙인다 — https 주소(Notion 이 가져온다)·글(text)·base64(5MB 까지) 중 하나. attach_to_page_id 를 주면 그 페이지에 그림·PDF·파일 블록으로(또는 아이콘·커버·파일 속성으로) 붙인다. 붙이지 않은 업로드는 1시간 뒤 사라진다
- notion__get_blockRead
블록 하나 조회 — 종류·내용(마크다운)·설정(체크·언어·아이콘 등)·부모·자식 유무
- notion__get_commentRead
댓글 하나 조회 — 작성자·내용·첨부·토론 id
- notion__get_databaseRead
데이터베이스 정보와 구조 — 제목·위치·data source 목록과 각 속성의 이름·타입·선택지. 행을 조회·생성하거나 구조를 바꾸기 전에 여기서 확인한다. 결과: database_id · title · url · in_trash · data_sources[](data_source_id · 속성).
- notion__get_file_uploadRead
파일 업로드 상태 — file_upload_id 를 주면 그 하나(pending·uploaded·failed), 비우면 최근 업로드 목록
- notion__get_pageRead
페이지 정보 조회 — 제목·주소·부모·아이콘·커버·휴지통 여부·속성 값(데이터베이스 행이면 전 속성). 본문은 notion__read_page
- notion__get_page_markdownRead
Notion 이 만든 페이지 마크다운을 통째로 받는다(콜아웃·멘션·색 같은 Notion 고유 요소는 태그로). notion__edit_page 로 고칠 글은 이 결과에서 그대로 골라야 맞는다. 길면 offset 으로 이어 읽는다
- notion__get_page_propertyRead
페이지 속성 값 하나를 끝까지 — 관계·사람·긴 글처럼 notion__get_page 에서 잘리는(25개 넘는) 값을 페이지 넘김으로 읽는다
- notion__get_userRead
사용자 한 명 조회 — user_id 를 비우거나 'me' 면 이 연결(통합 봇)과 연결한 사람·워크스페이스
- notion__get_viewRead
보기 하나의 설정 — 종류·필터·정렬·그룹/날짜 속성 같은 구성
- notion__list_blocksRead
페이지·블록 바로 아래의 자식 블록 목록 — 특정 블록을 고치거나(notion__update_block) 그 뒤에 넣을 때(after_block_id) id 를 여기서 얻는다. 결과: 블록마다 id · type · has_children · text(300자까지), 더 있으면 next_cursor.
- notion__list_commentsRead
페이지·블록의 열린 댓글 목록 — 해결된 댓글은 API 에 보이지 않는다. 결과: 댓글마다 id(notion__update_comment · notion__delete_comment 용) · discussion_id(답글용) · author · created · text, 더 있으면 next_cursor.
- notion__list_custom_emojisRead
워크스페이스 커스텀 이모지 목록 — 아이콘에 {"type":"custom_emoji","custom_emoji":{"id":…}} 로 쓸 id
- notion__list_templatesRead
데이터베이스 페이지 템플릿 목록 — notion__create_page · notion__update_page · notion__replace_page_content 의 template_id 에 쓴다. 결과: 템플릿마다 template_id · name · is_default.
- notion__list_usersRead
워크스페이스 사용자·봇 목록 — 담당자(people) 속성이나 멘션에 쓸 사용자 id 를 여기서 얻는다
- notion__list_viewsRead
데이터베이스의 보기(표·보드·캘린더·타임라인 등) 목록 — database_id 나 data_source_id 가 필요하다. 결과: 보기마다 view_id · name · type, 더 있으면 next_cursor.
- notion__query_databaseRead
데이터베이스 행 조회 — 필터·정렬·페이지 넘김. 간단히는 filter_property + filter_value(속성 타입에 맞게 일치 비교), 복잡한 조건은 filter 에 Notion 필터 객체(and/or)를 준다. 속성 이름은 notion__get_database 로 확인
- notion__query_meeting_notesRead
Notion AI 회의록 찾기 — 제목·상태·요약/메모 블록 id(notion__read_page 로 읽는다). 연결한 사용자가 참석자인 회의록만, 최대 50건
- notion__query_viewRead
저장된 보기 그대로 행 조회 — 사용자가 Notion 에서 만들어 둔 필터·정렬이 적용된다. 앞 10건은 속성까지. 이어 읽기는 결과 첫 줄의 query_id 와 next_cursor 로(15분 유효)
- notion__read_pageRead
페이지 본문을 마크다운으로 읽는다 — 서식·링크·표·토글·중첩 목록까지. 길면 나눠 읽도록 이어 읽기 커서를 준다. 블록 id 가 필요하면 notion__list_blocks
- notion__searchRead
Notion 페이지·데이터베이스 검색 — 제목으로 찾는다. 다른 Notion 도구를 쓰기 전에 먼저 불러 id 를 얻는다. 결과가 비면 그 페이지가 연동에 공유되지 않았을 수 있다. 결과: 항목마다 id · object · title · url · last_edited (데이터베이스 행의 id 는 data source id 이고 database_id 가 따로 붙는다), 더 있으면 마지막 줄에 next_cursor.