노션 자동화: MCP 없이 Claude Code에서 Notion API 직접 호출하는 스킬 (notion-pilot)

MCP 서버 없이 Claude Code에서 Notion API를 직접 호출해 DB·페이지·파일 업로드까지 자동화하는 notion-workspace 스킬을 소개합니다. 최신 마크다운 엔드포인트로 토큰을 절약하고, 인증/서버 이슈 없이 안정적으로 운영하며, 벌크 업서트 최적화까지 포함합니다.

1000쌤

Mar 20, 2026

Skill

노션 자동화: MCP 없이 Claude Code에서 Notion API 직접 호출하는 스킬 (notion-pilot)

📌

MCP 없이 Claude Code에서 Notion API 직접 호출하고 싶은데, 토큰 비용이랑 인증 문제 때문에 번번이 막히셨나요?

notion-pilot은 MCP 서버 없이 Node.js 모듈로 동작하며 Claude Code에서 곧바로 Notion API를 호출합니다. 최신 Notion API(2026-03-11)의 마크다운 엔드포인트까지 포함해, LLM-노션 연결에서 가장 큰 병목인 토큰 비용을 줄이고 운영 이슈(서버 컨디션, 인증 풀림)를 최소화합니다.

이 글에서 배울 내용 ⏳ 읽기 7분

MCP 없이 “즉시 호출” 구조가 왜 근본 해법인지

최신 API 풀스펙/검증이 ‘그냥 호출’과 다른 이유

벌크 업서트/마크다운 입출력으로 대량 작업 효율화하는 포인트

MCP 없이 Notion API를 직접 호출하면 뭐가 달라지나

서버 컨디션과 인증 이슈에서 자유로워집니다

Notion 자동화에서 중간 서버(MCP)를 두면 편해 보이지만, 운영에서는 새로운 변수가 생깁니다.

서버 상태(지연, 다운, 재시작)에 따라 자동화가 끊김

인증이 중간 계층에서 풀리거나 꼬이면서 “어제 되던 게 오늘 안 됨”이 발생

notion-pilot는 MCP 없이 Claude Code → Notion API 직결 구조로, 끊길 수 있는 지점을 하나 제거합니다.

토큰 비용이 줄어듭니다 (LLM-노션 연결의 병목 해소)

노션 자동화에서 토큰이 새는 대표 지점은 블록 API의 JSON 중첩 구조입니다. 읽을 때도 무겁고, 쓸 때는 더 무겁습니다.

notion-pilot는 Notion API 2026-03-11에서 추가된 마크다운 엔드포인트를 활용합니다.

읽기: 블록 JSON 대신 마크다운 문자열로 받아서 토큰 비용 절감(README 기준 20배)

쓰기: 블록 객체 조립 대신 마크다운 문자열로 작성(README 기준 6배)

콜아웃/토글/수식 같은 특수 블록도 마크다운 확장 문법으로 보존

‘API 호출 가능’과 ‘실전 스킬’의 차이

검증된 효율화 방법론이 포함되어 있습니다 (Bulk Upsert)

데이터를 “몇 건” 넣는 건 누구나 할 수 있습니다.

하지만 교사 업무 자동화는 보통 수십~수백 건이 기본이라, 속도와 안정성이 달라야 합니다.

notion-pilot은 upsert 패턴을 내장합니다.

10건 미만: upsertPage

10건 이상: bulkUpsert (DB 전체 캐시 후 동시성 15 병렬 처리)

100건 기준 33초(README 기준)
429 에러 0건(README 기준)

notion-pilot로 할 수 있는 일

Claude Code에서 이렇게 말하면 됩니다

노션에 DB 만들어줘

노션에 페이지 추가해

노션 DB 조회해줘

노션에 이미지 업로드해

노션 페이지 수정해

노션 페이지 내용 읽어줘

노션에 글 써줘

노션 페이지 이동해

지원 기능 요약

DB: 생성, 수정, 조회, 쿼리, 전체 조회(자동 페이지네이션)

페이지: 생성, 조회, 수정, 삭제, 이동

마크다운: 본문 읽기/쓰기(토큰 최적화)

파일: 로컬 업로드, URL 다운로드→업로드, 커버 설정, 이미지 블록 추가

코멘트: 생성, 목록 조회, 단건 조회

⚠️

주의

데이터베이스 뷰 생성, 노션 폼 생성은 Notion API 미지원이라 스킬에서도 지원하지 않습니다.

마크다운으로 bookmark/embed 쓰기는 미지원이라 필요 시 블록 API로 대체합니다.

설치 방법 (추천: 한 줄)

PowerShell 명령어


irm https://raw.githubusercontent.com/1000ssam/skills-for-teachers/main/skills/notion-pilot/install.ps1 | iex

사전 준비 (처음 한 번)

Node.js 설치: nodejs.org에서 LTS 설치

Notion Internal Integration 생성

notion.so/profile/integrations에서 새 API 통합 생성

Internal Integration Secret(ntn_ 시작) 발급

자동화할 페이지/DB를 해당 Integration에 공유

코멘트 기능을 쓰려면 Read/Insert comments 권한 활성화

📝

핵심 정리

요지는 “기능 나열”이 아니라, MCP 없이 Claude Code에서 즉시 Notion API 직접 호출한다는 구조입니다.

그 구조 위에 최신 마크다운 엔드포인트(토큰 절약), 벌크 업서트(대량 처리), ID 자동 변환(운영 안정성)이 올라갑니다.

수능 기출 PDF를 문항별 이미지로 자동 크롭하는 Claude Code 스킬 노션 데이터베이스 파일 일괄 다운로드 방법 (ZIP으로 한 번에)

1000쌤

노션 자동화: MCP 없이 Claude Code에서 Notion API 직접 호출하는 스킬 (notion-pilot)

MCP 없이 Notion API를 직접 호출하면 뭐가 달라지나

서버 컨디션과 인증 이슈에서 자유로워집니다

토큰 비용이 줄어듭니다 (LLM-노션 연결의 병목 해소)

‘API 호출 가능’과 ‘실전 스킬’의 차이

최신 API 풀스펙(2026-03-11) 기준으로 엔드포인트가 정의되어 있습니다

검증된 효율화 방법론이 포함되어 있습니다 (Bulk Upsert)

notion-pilot로 할 수 있는 일

Claude Code에서 이렇게 말하면 됩니다

지원 기능 요약

설치 방법 (추천: 한 줄)

PowerShell 명령어

사전 준비 (처음 한 번)

Related Posts

수능 기출 PDF를 문항별 이미지로 자동 크롭하는 Claude Code 스킬

노션 데이터베이스 파일 일괄 다운로드 방법 (ZIP으로 한 번에)

패들렛 노션 연동 크롬 익스텐션 - Padlet to Notion 사용법