gemmy-notion-mcp
Notion API MCP 서버. Claude Code에서 Notion 페이지/블록/DB 조작.
Based on awkoy/notion-mcp-server (MIT)
설치
.mcp.json:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "github:gemmy-jaeheon/gemmy-notion-mcp"],
"env": {
"NOTION_TOKEN": "ntn_YOUR_TOKEN",
"NOTION_PAGE_ID": "YOUR_PAGE_ID"
}
}
}
}
공식 MCP vs 이 Fork
| 기능 | 공식 (@notionhq) | 이 Fork | |------|:---:|:---:| | 블록 CRUD | ✅ | ✅ | | 데이터베이스 | ✅ | ✅ | | 코멘트/유저 | ✅ | ✅ | | 배치 작업 | ❌ | ✅ | | 부분 실패 처리 | ❌ | ✅ | | Windows 호환 | ⚠️ | ✅ |
기능
블록 (notion_blocks)
| Action | 설명 | |--------|------| | append_block_children | 블록 추가 | | retrieve_block | 블록 조회 | | retrieve_block_children | 하위 블록 조회 | | update_block | 블록 수정 | | delete_block | 블록 삭제 | | batch_append_block_children | 여러 블록 한번에 추가 | | batch_update_blocks | 여러 블록 한번에 수정 | | batch_delete_blocks | 여러 블록 한번에 삭제 | | batch_mixed_operations | 추가/수정/삭제 혼합 |
지원 블록: paragraph, heading, callout, quote, toggle, bulleted_list, numbered_list, to_do, code, divider, image
페이지 (notion_pages)
create_page, update_page_properties, archive_page, restore_page, search_pages
데이터베이스 (notion_database)
create_database, query_database, update_database
코멘트 (notion_comments)
get_comments, add_page_comment, add_discussion_comment
유저 (notion_users)
list_users, get_user, get_bot_user
사용 예시
"이 페이지에 체크리스트 3개 추가해줘"
"테스트 DB에서 Status가 Todo인 항목만 조회"
"회의록 페이지 만들고 콜아웃으로 요약 넣어줘"










