> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/user-guide/undefined-1/notion.md).

# Notion

에이전트에 Notion을 연결하면 페이지를 검색하고, 읽고, 만들고, 수정하고, 댓글을 달고, 데이터베이스까지 대화만으로 관리할 수 있어요. 법령·일정·메일과 연계하면 정리 업무가 한 문장으로 끝납니다.

### 개요

핵심 기능은 **페이지 검색·읽기 / 페이지 생성·수정 / 댓글 달기 / 데이터베이스 관리** 네 가지입니다.

![Notion 도구 가이드 — 4가지 핵심 기능 소개](https://deck.onpod.ai/d/9gHLLt/p/65.jpg)

키워드로 문서 찾기, 접근 가능한 페이지 목록 조회, 본문 확인·요약, 제목+내용을 지정한 페이지 생성, 기존 페이지에 내용 추가, 댓글 작성, 컬럼을 직접 지정한 데이터베이스 생성, 기존 데이터베이스에 항목 추가까지 — Notion에서 손으로 하던 여덟 가지 작업을 대화로 처리합니다.

![Notion으로 할 수 있는 것 — 8가지 작업](https://deck.onpod.ai/d/9gHLLt/p/66.jpg)

### 페이지 검색·목록 조회

키워드로 문서를 찾고, 접근 가능한 페이지 목록을 한눈에 확인합니다.

> "Notion에서 '회의록' 관련 문서 찾아줘"
>
> "Notion에 어떤 페이지가 있어?"

검색 결과에는 페이지 제목, 바로 열 수 있는 링크, 마지막 수정 시각이 함께 표시됩니다. "test 관련 문서 찾아줘"처럼 키워드만 주면 워크스페이스 전체에서 찾아줘요.

![페이지 검색·목록 조회 — 검색 결과와 전체 페이지 목록](https://deck.onpod.ai/d/9gHLLt/p/67.jpg)

### 페이지 내용 읽기

특정 페이지의 본문을 확인하고, 요약이나 편집을 이어서 요청합니다.

> "test 페이지 내용 보여줘"
>
> "'프로젝트 현황' 페이지 내용 요약해줘"

본문을 확인한 뒤 "요약해줘", "여기에 추가해줘" 같은 작업을 바로 이어갈 수 있습니다.

![페이지 내용 읽기 — 본문 확인 결과](https://deck.onpod.ai/d/9gHLLt/p/68.jpg)

{% hint style="info" %}
내용을 먼저 읽고 작업하세요 — 읽기 → 확인 → 수정 순서로 하면 실수를 줄일 수 있습니다.
{% endhint %}

### 페이지 생성

제목과 내용을 지정하면 새 Notion 페이지가 만들어집니다.

> "Notion에 'MCP TEST' 페이지 만들어줘. 본문은 'MCP 테스트'"
>
> "Notion에 '3월 주간회의록' 페이지 만들어줘. 내용: 참석자 전원 / 1분기 실적 리뷰 완료 / 2분기 목표 매출 20% 성장"

제목과 본문을 같이 적으면 한 번에 생성됩니다. 목록 내용은 불릿으로 정리되어 들어가요. 회의 내용을 받아 적게 한 뒤 "주간회의록 페이지로 만들어줘"라고 하면 정리까지 한 번에 끝납니다.

![페이지 생성 — 대화 요청과 실제 Notion에 생성된 페이지](https://deck.onpod.ai/d/9gHLLt/p/69.jpg)

### 페이지 수정 — 내용 추가

기존 페이지에 새 내용을 덧붙입니다.

> "test 페이지 본문에 '추가 내용입니다' 추가해줘"
>
> "'프로젝트 현황' 페이지에 오늘 진행상황 추가해줘: 디자인 시안 1차 완료"

"test 페이지 본문에 추가해줘"처럼 페이지 이름을 명시하면 정확하게 찾아 추가합니다.

![페이지 수정 — 내용 추가 요청과 실제 반영된 모습](https://deck.onpod.ai/d/9gHLLt/p/70.jpg)

{% hint style="info" %}
수정 전에 "내용 보여줘"로 현재 상태를 먼저 확인하면 더 안전합니다.
{% endhint %}

### 댓글 달기

페이지에 코멘트를 남겨 협업 흐름을 이어갑니다.

> "test 페이지에 '확인했습니다' 댓글 달아줘"
>
> "'기획서' 페이지에 '수정 필요합니다' 댓글 남겨줘"

따옴표로 적은 댓글 문구가 그대로 페이지에 달립니다. 검토를 마친 문서마다 "확인했습니다" 댓글을 달아 진행 상황을 남길 수 있어요.

![댓글 달기 — 요청과 실제 Notion 페이지에 달린 댓글](https://deck.onpod.ai/d/9gHLLt/p/71.jpg)

### 데이터베이스 생성

원하는 컬럼 구조를 직접 지정해 새 데이터베이스를 만듭니다.

> "test 페이지에 프로젝트 관리 DB 만들어줘. 프로젝트명: 제목 / 상태: 예정·진행 중·완료·보류 / 담당자: 사람 / 마감일: 날짜 / 우선순위: 높음·중간·낮음 / 비고: 텍스트"

컬럼명, 타입(텍스트·날짜·선택·사람 등), 선택 옵션까지 적으면 원하는 구조 그대로 만들어집니다. "MCP 테스트 페이지 안에 새 데이터베이스 만들어줘"처럼 위치(상위 페이지)도 지정할 수 있어요.

![데이터베이스 생성 — 컬럼 구조를 지정한 생성 요청과 결과](https://deck.onpod.ai/d/9gHLLt/p/72.jpg)

### 데이터베이스 항목 추가

기존 데이터베이스에 새 행을 추가합니다.

> "프로젝트 관리 DB에 항목 추가해줘. 프로젝트명: 앱 개발, 상태: 예정, 우선순위: 높음"
>
> "DB 항목 추가 — 프로젝트명: 홈페이지 리뉴얼, 상태: 진행 중"

"컬럼명: 값" 형식으로 적으면 각 컬럼에 정확히 들어갑니다.

![데이터베이스 항목 추가 — 요청과 실제 DB에 추가된 항목](https://deck.onpod.ai/d/9gHLLt/p/73.jpg)

{% hint style="info" %}
선택형 컬럼은 DB에 정의된 옵션명(예: 예정/진행 중)과 똑같이 적어주세요.
{% endhint %}

### 연계 활용 1 — 법령 검색 후 Notion 정리

다른 도구로 찾은 내용을 Notion 페이지로 바로 정리합니다.

> "형법 제1조 전문을 알려줘. 그리고 Notion에 '형법'이라는 제목으로 문서 만들어줘"

"…찾아줘. 그리고 Notion에 정리해줘" — 조회와 기록을 한 문장에 담으면 됩니다.

![연계 활용 1 — 법령 검색 결과가 Notion 문서로 정리된 모습](https://deck.onpod.ai/d/9gHLLt/p/74.jpg)

{% hint style="info" %}
국가법령정보 도구가 함께 연결된 에이전트에서 사용할 수 있습니다.
{% endhint %}

### 연계 활용 2 — 일정·메일을 Notion으로

캘린더 일정이나 메일을 검색해 Notion 페이지에 정리합니다.

> "기본 캘린더에서 이번주 화요일부터 주간 일정 확인하고 Notion MCP TEST 페이지에 정리해줘"
>
> "받은 편지함에서 제목에 '회의록' 키워드 검색 후 Notion MCP TEST 페이지에 정리해줘"

"기본 캘린더", "MCP TEST 페이지"처럼 캘린더와 페이지명을 구체적으로 지정하면 더 정확하게 작동합니다.

![연계 활용 2 — 주간 일정이 Notion 페이지에 정리된 결과](https://deck.onpod.ai/d/9gHLLt/p/75.jpg)

{% hint style="info" %}
Google Calendar·Microsoft 365 도구가 함께 연결된 에이전트에서 사용할 수 있습니다.
{% endhint %}

### 활용 팁

1. **페이지 이름을 정확히 말하세요** — "test 페이지에 추가해줘"처럼 페이지 이름을 명시하면 정확하게 찾습니다.
2. **내용을 먼저 읽고 작업하세요** — "내용 보여줘" → 확인 → "추가해줘" 순서로 하면 실수를 줄일 수 있습니다.
3. **DB 컬럼은 상세하게 지정하세요** — 컬럼명, 타입, 선택 옵션까지 적으면 원하는 구조로 만들어집니다.
4. **연계 작업을 활용하세요** — "법령 찾아서 Notion에 정리", "일정 확인해서 Notion에 기록" 같은 복합 요청이 가능합니다.

함께 보면 좋은 가이드: **Microsoft 365 도구 가이드**(메일·Teams 내용을 Notion으로 정리할 때), **Google Calendar 도구 가이드**(캘린더 일정을 Notion으로 정리할 때).

![활용 팁 — 페이지 이름·작업 순서·컬럼 지정·연계와 함께 보면 좋은 가이드](https://deck.onpod.ai/d/9gHLLt/p/76.jpg)

![Notion 정리, 이제 대화로 끝내세요 — 시작해 볼 만한 예시](https://deck.onpod.ai/d/9gHLLt/p/77.jpg)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/user-guide/undefined-1/notion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.