Skip to main content
Glama
gemmy-notion-mcp

gemmy-notion-mcp

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

설명

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인 항목만 조회"
"회의록 페이지 만들고 콜아웃으로 요약 넣어줘"

Available Tools

5 tools
notion_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

    B3.1/5.0

    Scored across 5 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers