Community생산성 & 협업github.com

notiondevs/Notion-Skills-for-Claude

Notion 데이터베이스, 페이지, 워크스페이스 데이터를 다루기 위한 스킬

Notion-Skills-for-Claude란 무엇인가요?

이 스킬은 Claude AI 에이전트가 Notion API를 통해 사용자의 노션 워크스페이스 데이터를 읽고, 쓰고, 수정할 수 있도록 지원합니다. 데이터베이스 조회, 페이지 생성 및 업데이트, 블록 편집, 검색 등 노션의 핵심 기능을 자연어 명령으로 실행할 수 있습니다. 개발자나 파워 유저가 Notion을 보다 효율적으로 관리하고 자동화하는 데 매우 유용하며, Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트 플랫폼에서 사용할 수 있습니다. SKILL.md 문서에 따라 API 키 설정과 OAuth 인증을 지원하며, 사용자의 Notion 통합 권한에 따라 안전하게 작동합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add notiondevs/Notion-Skills-for-Claude

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Notion-Skills-for-Claude은(는) 무엇을 하나요?

Notion 데이터베이스, 페이지, 워크스페이스 데이터를 다루기 위한 스킬

개요

이 스킬을 사용하면 Claude가 Notion API를 사용하여 다음 작업을 수행할 수 있습니다:

  • 데이터베이스 쿼리 및 조회
  • 페이지 생성, 읽기, 업데이트
  • 블록 콘텐츠 관리
  • 워크스페이스 검색
  • 사용자 및 팀 관리

설정

  1. Notion Integrations에서 통합(Integration)을 생성합니다.
  2. 통합에 필요한 권한을 설정합니다.
  3. Notion 페이지 또는 데이터베이스를 통합과 공유합니다.
  4. 다음 환경 변수를 설정합니다:
NOTION_TOKEN=your_integration_token_here
NOTION_DATABASE_ID=your_database_id_here (선택 사항)

사용 예시

데이터베이스 쿼리

"프로젝트 데이터베이스에서 모든 항목을 가져와줘"

페이지 생성

"데이터베이스에 새 작업 항목을 생성해줘. 제목은 '새로운 기능 개발', 상태는 '진행 중'으로 설정해"

페이지 업데이트

"방금 생성한 페이지의 설명을 '버그 수정 포함'으로 업데이트해줘"

지원되는 작업

  • query_database: 데이터베이스 내용 조회
  • create_page: 새 페이지 생성
  • update_page: 기존 페이지 업데이트
  • get_page: 페이지 세부 정보 가져오기
  • search: 워크스페이스 검색
  • list_users: 워크스페이스 사용자 목록
  • get_database: 데이터베이스 스키마 정보

참고 사항

  • API 키는 안전하게 보관하세요.
  • Notion API에는 속도 제한이 있습니다.
  • 일부 고급 기능(예: 데이터베이스 관계, 롤업)은 복잡한 처리가 필요할 수 있습니다.

관련 스킬