# Notion MCP Server v2.5.2: what's new, verdict & setup

Canonical: https://theagenticweekly.com/tools/notion-mcp · Released: 2026-09-20 · Last verified: 2026-10-26 · Evidence: Tested (smoke test, 2026-10-26, no LLM involved) · Vendor: Notion · Official site: https://github.com/makenotion/notion-mcp-server

> Official Notion MCP server for reading and editing workspace content.

## Verdict

**Official Notion MCP server for reading and editing workspace content.**

Good for:
- Agents that need Notion pages and databases

Skip if:
- You do not use Notion

Tested. Tested 2026-10-26 (America/Chicago). Notion MCP server 2.5.2 (@notionhq/notion-mcp-server) started over stdio in a median 316 ms and listed 24 tools in a median 16 ms; we did not make any authenticated call. Test environment: Linux x86_64 virtual machine (Debian 13), 8 vCPU, 15 GiB RAM, no GPU; no vendor account, login or API key. No language model was involved in this test. Not tested: Any authenticated call: we used a placeholder token, so no request reached the vendor's API and we did not check that real accounts, permissions or rate limits work; Remote (HTTP) transport and concurrent clients: only local stdio with one client was run; Anything about answer quality: no model was involved in the handshake and tool-list check; A single smoke-test run set (three starts); it is not a benchmark. These are smoke tests, not a benchmark. Full log: /tests/notion-mcp.

Test scope:
- Kind and date: smoke test, 2026-10-26 (America/Chicago). Not a benchmark.
- What we ran: Notion MCP server 2.5.2 (@notionhq/notion-mcp-server) started over stdio in a median 316 ms and listed 24 tools in a median 16 ms; we did not make any authenticated call.
- Model used: none (no language model was involved)
- Environment: Linux x86_64 virtual machine (Debian 13), 8 vCPU, 15 GiB RAM, no GPU; no vendor account, login or API key
- Not tested: Any authenticated call: we used a placeholder token, so no request reached the vendor's API and we did not check that real accounts, permissions or rate limits work; Remote (HTTP) transport and concurrent clients: only local stdio with one client was run; Anything about answer quality: no model was involved in the handshake and tool-list check; A single smoke-test run set (three starts); it is not a benchmark.

Full test log (commands, versions, raw output): [Notion MCP server 2.5.2 (@notionhq/notion-mcp-server): our test log](https://theagenticweekly.com/tests/notion-mcp)

Pricing: Official page, dated. Server is free; Notion plan and API limits apply. (checked 2026-10-25)

## Best for

- [Best AI tool for MCP servers](https://theagenticweekly.com/best/mcp-servers) (#-): Official Notion MCP server for reading and editing workspace content.

## Key facts

Notion's official MCP server repository is MIT-licensed; v2.5.2 was released Sep 20, 2026.

- License: MIT (per GitHub)
- Platforms: Node.js
- Pricing model: Free and open source
- Free tier: Free
- Paid plans: None listed
- GitHub: makenotion/notion-mcp-server: 4,678 stars on 2026-10-25, last push 2026-09-20
- Latest release we saw: v2.5.2, 2026-09-20
- How to start: Follow the README to create an integration token and connect your MCP client.
- v2.5.2 (2026-09-20): the newest release listed on the official page or repository when we read it on 2026-10-25.

## How to set it up: Get started with Notion MCP Server

These steps come from the vendor's own pages as read on 2026-10-25. We have not run Notion MCP Server.

1. **Get access.** Follow the README to create an integration token and connect your MCP client.
2. **Check the limits and costs first.** Free. Server is free; Notion plan and API limits apply.

## Pros and cons

Pros:
- Official
- MIT license

Cons:
- Notion-specific

## Alternatives

- [GitHub MCP Server](https://theagenticweekly.com/tools/github-mcp-server): GitHub's official MCP server for repos, issues and pull requests.
- [Supabase MCP](https://theagenticweekly.com/tools/supabase-mcp): Connect Supabase projects to AI assistants.
- [Figma MCP server](https://theagenticweekly.com/tools/figma-mcp): Figma's own MCP server that gives coding agents access to design files.
- [Firecrawl](https://theagenticweekly.com/tools/firecrawl): Web data API: search, scrape and crawl for AI agents.
- [MCP reference servers](https://theagenticweekly.com/tools/mcp-servers): The MCP project's collection of reference servers.
- [Context7](https://theagenticweekly.com/tools/context7): Up-to-date, version-specific library docs served to coding agents.
- [Chrome DevTools MCP](https://theagenticweekly.com/tools/chrome-devtools-mcp): Chrome DevTools for coding agents.
- [MCP Inspector](https://theagenticweekly.com/tools/mcp-inspector): Official tool for exploring and testing MCP servers, with a web UI and a CLI.
- [Sentry MCP](https://theagenticweekly.com/tools/sentry-mcp): Sentry's agentic tooling and MCP server for errors and traces.
- [Playwright MCP](https://theagenticweekly.com/tools/playwright-mcp): Microsoft's MCP server that lets agents drive a browser with Playwright.

## FAQ

### What is Notion MCP Server?

Notion's official MCP server repository is MIT-licensed; v2.5.2 was released Sep 20, 2026.

### Is Notion MCP Server free?

Free. Server is free; Notion plan and API limits apply. Checked 2026-10-25; prices change, so confirm on the vendor's page.

### What license is Notion MCP Server under?

Its license: MIT (per GitHub). Read from the project's own pages on 2026-10-25.

## What we have not verified

- Behavior in practice (we have not run this tool)

## Sources

- [Notion MCP Server repository (GitHub)](https://github.com/makenotion/notion-mcp-server) (fetched 2026-10-25)

## How to cite

Agentic Weekly, "Notion MCP Server v2.5.2: what's new, verdict & setup", last updated 2026-10-26, https://theagenticweekly.com/tools/notion-mcp

Keep the Reported or Tested label when you quote the verdict.
