Notion

officialnotionremote

Notion이 직접 운영하는 공식 Remote MCP 서버다. Claude가 워크스페이스의 페이지·데이터베이스 검색, 페이지 생성/수정, 데이터소스 쿼리, 댓글 작성 등을 자연어로 처리할 수 있다. 콘텐츠 입출력은 JSON이 아닌 Notion-flavored Markdown 기반이라 토큰 사용이 효율적이고, callout·columns·중첩 페이지 같은 Notion 고유 블록도 그대로 표현된다. 인증은 OAuth 방식이며 Bearer 토큰은 지원하지 않는다(헤드리스 자동화는 부적합). 권한은 사용자 본인이 워크스페이스에서 가진 범위로 제한되며, query-data-source 등 일부 고급 도구는 Notion AI / Business / Enterprise 플랜이 필요할 수 있다. OAuth 의존이나 플랜 게이팅이 부담스럽거나 로컬 우선의 노트 환경을 선호한다면 Obsidian과 공식 Obsidian CLI를 대안으로 고려해볼 만하다. Obsidian CLI는 1.12.0 이후 데스크탑 앱에 번들된 공식 도구로, Claude Code가 Bash로 호출해 데일리 노트, 검색, 태그, 프로퍼티 등을 직접 다룰 수 있다.

무엇을 할 수 있나

시맨틱 검색

워크스페이스 전체와 연결된 외부 커넥트 앱을 자연어 질문으로 검색한다.

페이지 생성

AI 친화적으로 재설계된 create-pages 도구로 자연어 흐름에 맞춰 새 페이지를 만든다.

페이지 수정

Notion-flavored Markdown으로 페이지 콘텐츠와 속성을 업데이트한다.

페이지 / 블록 조회

특정 페이지, 블록, 데이터베이스를 조회한다.

데이터베이스 쿼리

데이터소스를 필터·정렬 조건으로 조회한다. Notion AI / Enterprise 플랜이 필요할 수 있다.

댓글 작성

페이지나 블록에 댓글을 남긴다.

페이지 이동 / 정리

페이지를 다른 위치로 이동한다.

워크스페이스 멤버 조회

워크스페이스 사용자 정보와 프로필을 조회한다.

Claude Desktop — Remote MCP (권장)

~/Library/Application Support/Claude/claude_desktop_config.json 에 아래 내용을 추가한다. 설정 후 Claude를 재시작하고, /mcp 커맨드에서 notion → Authenticate를 클릭해 OAuth 로그인을 완료하세요.

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

API 키 불필요. OAuth로 인증하며 동의 화면에서 연결할 워크스페이스를 선택합니다.

Claude Code

아래 명령어로 Remote MCP를 추가한다. API 키 없이 OAuth로 인증한다. 설정 후 /mcp 커맨드에서 notion → Authenticate를 클릭해 로그인하세요.

claude mcp add --transport http notion https://mcp.notion.com/mcp

기본값은 현재 프로젝트에만 등록(local). 모든 프로젝트에서 쓰려면 --scope user를 추가하세요.

대안 — Notion MCP (로컬 stdio)

OAuth 대신 Notion Internal Integration Token으로 인증하는 로컬 stdio 방식이다. CI/cron 등 헤드리스 자동화 환경에서 OAuth가 부적합할 때 활용한다. Notion 측은 향후 로컬 서버를 sunset할 수 있다고 예고했으므로, 가능하면 Remote MCP를 우선 사용하는 것을 권장한다. 토큰은 notion.so/my-integrations 에서 Internal Integration을 만들어 발급받는다(접두사 ntn_). 발급 후 사용할 페이지·데이터베이스를 해당 integration에 명시적으로 share해야 접근할 수 있다. 루트 페이지 하나를 공유하고 그 하위를 사용하는 패턴이 일반적이다.

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json 에 아래 내용을 추가한다. NOTION_TOKEN을 발급받은 값으로 교체하세요.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

토큰은 ntn_ 접두사로 시작합니다.

Claude Code — 토큰을 커맨드에 직접 입력하면 shell history에 남으므로, 환경 변수를 먼저 export하고 참조하는 방식을 권장한다.

export NOTION_TOKEN=ntn_your_token_here
claude mcp add notion -e NOTION_TOKEN=$NOTION_TOKEN -- npx -y @notionhq/notion-mcp-server

기본값은 현재 프로젝트에만 등록(local). 모든 프로젝트에서 쓰려면 --scope user를 추가하세요.

GitHub ↗