awkoy/notion-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

179 stars 41 forks 품질 92 트렌드 37MIT

Repository Install

awkoy/notion-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

awkoy/notion-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

notion-mcp-server는 모델 컨텍스트 프로토콜(MCP) 서버로, Claude Code, Claude Desktop, Cursor, VS Code, Codex 및 기타 모든 MCP 클라이언트가 하나의 토큰으로 Notion에 읽기/쓰기 권한을 부여합니다. AI는 페이지를 검색, 생성 및 편집하고, 데이터베이스를 쿼리하며, 댓글 작성과 파일을 평이한 언어로 업로드할 수 있습니다.

모든 Notion 요금제에서 토큰 인증, 무료 포함. 브라우저 로그인이 없어서 CI, cron 작업, 백그라운드 에이전트, 그리고 자신의 서버에서도 헤드리스로 실행됩니다.
맥락 부족. 세 가지 도구는 연결 시 1,005 토큰 비용이 들었으며, Notion의 오픈소스 서버는 17,163 토큰이며, 페이지 읽기 횟수는 82% 적습니다. 벤치마크 →
에이전트를 위해 빌드됨. 배치 작성은 원자 롤백 및 멎등성 키, 속도 제한 재시도, 마크다운 입출력 및 오류 및 모델에 호출 수정 방법을 알려주는 오류를 포함합니다.

퀵 스타트

1. Notion 토큰을 받아라. app.notion.com/developers/tokens→ + 새 토큰 → 이름을 고, →작업 공간을 선택하세요 토큰 생성 → ntn_… 값을 복사하세요. Personal Access Token은 당신이 볼 수 있는 모든 것을 볼 수 있으며, 페이지당 공유는 없습니다. 생성할 수 없나요? 다른 토큰 옵션을 확인하세요.

2. 설치하세요.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Notion MCP Server — Connect Claude, Cursor, VS Code & Codex to Notion

notion-mcp-server is a Model Context Protocol (MCP) server that gives Claude Code, Claude Desktop, Cursor, VS Code, Codex and any other MCP client read/write access to Notion with one token. Your AI can search, create and edit pages, query databases, comment and upload files, in plain language.

Token auth on every Notion plan, Free included. No browser sign-in, so it also runs headless: in CI, cron jobs, background agents and on your own server.
Light on context. Its three tools cost 1,005 tokens at connection, against 17,163 for Notion’s open-source server, and page reads come back 82% smaller. Benchmark →
Built for agents. Batched writes with atomic rollback and idempotency keys, retry on rate limits, markdown in and out, and errors that tell the model how to fix the call.

Quick start

1. Get a Notion token. Open app.notion.com/developers/tokens → + New token → name it, pick your workspace → Create token → copy the ntn_… value. A Personal Access Token sees everything you can see, with no per-page sharing. Can’t create one? See the other token option.

2. Install it.

npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here

add-mcp finds the MCP clients on your machine and writes the config for the ones you pick: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Cline, Windsurf, Zed and more. Add -g to install for your user instead of the current project.

Keep the --env flag. Without it the entry is written without a token, and every call fails with an auth error.

Or install in one click:

GitHub에서 전체 README 보기

설치

npx -y notion-mcp-server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_paste_your_token_here" }
    }
  }
}