# mcp-server-notion: A Notion MCP Tool

## Overview

mcp-server-notion은 Notion에 글을 작성하는 기능을 MCP(Model Context Protocol) Tool로 제공합니다. LLM 프롬프트, Claude, uvx 등에서 직접 호출하여 Notion 페이지를 자동으로 생성할 수 있습니다.

---

## 주요 기능 (MCP Tool)

- `notion_create_page`: Notion 데이터베이스에 새 페이지를 생성합니다.
  - 입력값:
    - `notion_token` (string): Notion API 통합 토큰
    - `parent_id` (string): 페이지를 생성할 데이터베이스 ID
    - `title` (string): 페이지 제목
    - `content` (string): 페이지 본문
  - 반환값: 생성된 페이지의 URL

---

## 설치

```bash
pip install mcp-server-notion
```

---

## 사용법 (MCP Tool)

### MCP 프롬프트/uvx/Claude Desktop 연동 예시

#### claude_desktop_config.json
```json
"mcpServers": {
  "notion": {
    "command": "uvx",
    "args": ["mcp-server-notion"]
  }
}
```

#### VS Code .vscode/mcp.json
```json
{
  "mcp": {
    "servers": {
      "notion": {
        "command": "uvx",
        "args": ["mcp-server-notion"]
      }
    }
  }
}
```

---

## MCP Tool 프롬프트 예시

- notion_create_page tool을 호출할 때 아래와 같이 입력:

```json
{
  "notion_token": "your_notion_token",
  "parent_id": "your_database_id",
  "title": "회의록",
  "content": "오늘 회의 내용 정리"
}
```

- 반환 예시:
  - `페이지 생성됨: https://www.notion.so/xxxxxxx`

---

## Notion API 토큰 발급 방법

1. [Notion 개발자 페이지](https://www.notion.so/my-integrations)에서 통합 생성
2. 해당 통합을 원하는 데이터베이스에 초대
3. 통합 토큰 복사 후 notion_token으로 사용

---

## License

MIT License
