MCP servers / @notionhq/notion-mcp-server

MCP tool changes

@notionhq/notion-mcp-server

No tool definition changed across the 6 releases that started, up to 2.5.2.

npm package · npm page · recorded on 24 October 2026 on a clean machine with placeholder settings; only tools/list was sent. A changed description is not a vulnerability. Method and limits.

Release by release

2.5.1 → 2.5.2

patch release, 20 September 2026

No tool definition changed.

2.5.0 → 2.5.1

patch release, 25 July 2026

No tool definition changed.

2.4.1 → 2.5.0

minor release, 24 July 2026

No tool definition changed.

2.4.0 → 2.4.1

patch release, 22 June 2026

No tool definition changed.

2.3.1 → 2.4.0

minor release, 17 June 2026

No tool definition changed.

Releases tried: 2.3.1 (2026-06-17); 2.4.0 (2026-06-17); 2.4.1 (2026-06-22); 2.5.0 (2026-07-24); 2.5.1 (2026-07-25); 2.5.2 (2026-09-20).

Tools in 2.5.2

The pin is the SHA-256 of the tool's name, description and input schema, as verfy.lock records it. The same pin in your lock means your agent reads this exact definition.

Tools in 2.5.2
ToolDescriptionPin
API-get-userNotion | Retrieve a user Error Responses: 400: 4003fbfb4bfce3d
API-get-usersNotion | List all users Error Responses: 400: 400684bcb9e5dcb
API-get-selfNotion | Retrieve your token's bot user Error Responses: 400: Bad requestd8b034dc7234
API-post-searchNotion | Search by title Error Responses: 400: Bad request97667005b47d
API-get-block-childrenNotion | Retrieve block children Error Responses: 400: Bad request8696581b6784
API-patch-block-childrenNotion | Append block children Error Responses: 400: Bad request3ff2af640d7e
API-retrieve-a-blockNotion | Retrieve a block Error Responses: 400: Bad request954c91fb0520
API-update-a-blockNotion | Update a block Error Responses: 400: Bad requeste49d14b8deb0
API-delete-a-blockNotion | Delete a block Error Responses: 400: Bad request89bd389a9c83
API-retrieve-a-pageNotion | Retrieve a page Error Responses: 400: Bad requestd989fef17a77
API-patch-pageNotion | Update page properties Error Responses: 400: Bad request1dffe804c363
API-post-pageNotion | Create a page Error Responses: 400: Bad requestfc8c35ba481d
API-retrieve-a-page-propertyNotion | Retrieve a page property item Error Responses: 400: Bad requestd49b9a09aa72
API-retrieve-a-commentNotion | Retrieve comments Error Responses: 400: Bad request86e8d4d07f25
API-create-a-commentNotion | Create comment Error Responses: 400: Bad requestad6b6159990e
API-query-data-sourceNotion | Query a data source Error Responses: 400: Bad request2c502fa9b76e
API-retrieve-a-data-sourceNotion | Retrieve a data source Error Responses: 400: Bad request820189b6b737
API-update-a-data-sourceNotion | Update a data source Error Responses: 400: Bad requestfabf28f47acd
API-create-a-data-sourceNotion | Create a data source Error Responses: 400: Bad requestb4809ea89e10
API-list-data-source-templatesNotion | List templates in a data source Error Responses: 400: Bad request3ca0ceca8064
API-retrieve-a-databaseNotion | Retrieve a database Error Responses: 400: Bad request1ba6e09b7303
API-move-pageNotion | Move a page Error Responses: 400: Bad requeste3cef1709a55
API-retrieve-page-markdownNotion | Retrieve a page as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 429: Rate limited.b23669ffea12
API-update-page-markdownNotion | Update a page's content as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 409: Conflict (e.g. row limit exceeded). 429: Rate limited.43a9e47ee2b6

Lock these tools

Pin what @notionhq/notion-mcp-server serves you today, commit the lock, and a pull request fails when a tool changes, with the text before and after. Pin the package version in your MCP config as well.

$ pip install verfy
$ verfy lock check --update   # shows each tool, then writes verfy.lock
$ git add verfy.lock
# .github/workflows/verfy.yml, after actions/checkout
- uses: anvarbekovjavohir277-dot/verfy-action@v1

Maintain this server? Run the same check on your releases and add the Locked by Verfy badge to your README.