gemmy-notion-mcp
Provides tools for managing Notion pages, blocks, databases, comments, and users, including batch operations and partial failure handling.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gemmy-notion-mcp append a bullet list with meeting agenda to Notion page"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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"
}
}
}
}Related MCP server: Notion MCP Server
공식 MCP vs 이 Fork
기능 | 공식 (@notionhq) | 이 Fork |
블록 CRUD | ✅ | ✅ |
데이터베이스 | ✅ | ✅ |
코멘트/유저 | ✅ | ✅ |
배치 작업 | ❌ | ✅ |
부분 실패 처리 | ❌ | ✅ |
Windows 호환 | ⚠️ | ✅ |
기능
블록 (notion_blocks)
Action | 설명 |
| 블록 추가 |
| 블록 조회 |
| 하위 블록 조회 |
| 블록 수정 |
| 블록 삭제 |
| 여러 블록 한번에 추가 |
| 여러 블록 한번에 수정 |
| 여러 블록 한번에 삭제 |
| 추가/수정/삭제 혼합 |
지원 블록: 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인 항목만 조회"
"회의록 페이지 만들고 콜아웃으로 요약 넣어줘"Available Tools
5 toolsnotion_blocksC
Perform various block operations (retrieve, update, delete, append children, batch operations)
Inputs: payload (required).
notion_commentsC
Perform various comment operations (get, add to page, add to discussion)
Inputs: payload (required).
notion_databaseC
Perform various database operations (create, query, update)
Inputs: payload (required).
notion_pagesC
Perform various page operations (create, archive, restore, search, update)
Inputs: payload (required).
notion_usersC
Perform various user operations (list, get, get bot)
Inputs: payload (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool maps to a distinct Notion resource (pages, blocks, databases, comments, users), so an agent can generally choose the right tool by resource. However, each tool bundles multiple operations, creating some internal ambiguity, and page-level versus block-level updates may be confused in edge cases.
All tools use the consistent notion_<resource> prefix, and four of five resources are pluralized uniformly. The singular notion_database is a minor deviation from the otherwise plural resource naming pattern.
Five resource-oriented tools are reasonable for a Notion integration and keep the surface compact. The tradeoff is that several tools are broad multi-operation wrappers rather than focused single-action tools, which makes the count feel slightly under-granular.
The surface covers the major Notion resources and supports key lifecycle operations such as page create/archive/restore/search/update, block append/update/delete, and database create/query/update. Some gaps exist, such as explicit page retrieval or delete for databases/comments, but agents can likely work around them.
Related MCP Connectors
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.209MIT
- AlicenseAqualityCmaintenanceMCP Server for the Notion API, enabling Claude to interact with Notion workspaces.313,089 npm925MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the Notion API, enabling management of pages, blocks, databases, data sources, comments, and users through natural language.12 npm3MIT
- FlicenseAqualityDmaintenanceEnables interaction with Notion workspaces through a comprehensive set of tools for managing pages, blocks, databases, users, comments, and search. Provides both a clean Python API and an MCP server for use with Claude Desktop.21-