# better-notion-mcp

> Markdown-first MCP server for Notion API - composite tools optimized for AI agents

- **URL**: https://www.freshcrate.ai/projects/better-notion-mcp
- **Author**: n24q02m
- **Category**: MCP Servers
- **Latest version**: `v2.34.4` (2026-06-01)
- **License**: MIT
- **Source**: https://github.com/n24q02m/better-notion-mcp
- **Homepage**: https://www.npmjs.com/package/@n24q02m/better-notion-mcp
- **Language**: TypeScript
- **GitHub**: 26 stars, 10 forks
- **Registry**: github
- **Tags**: `ai-agents`, `ai-coding`, `claude`, `claude-code`, `cursor`, `docker`, `markdown`, `mcp`, `model-context-protocol`, `typescript`

## Description

Markdown-first MCP server for Notion API - composite tools optimized for AI agents

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.34.4` | 2026-06-01 | High | ## v2.34.4 (2026-06-01)  ### Bug Fixes  - Pin mcp-core 1.17.2 (stable) ([`584ec47`](https://github.com/n24q02m/better-notion-mcp/commit/584ec47cdda5d87d1d59afdcb1c8f445a4331105))  ---  **Detailed Changes**: [v2.34.4-beta.1...v2.34.4](https://github.com/n24q02m/better-notion-mcp/compare/v2.34.4-beta.1...v2.34.4) |
| `v2.34.0` | 2026-05-26 | High | ## v2.34.0 (2026-05-26)  ---  **Detailed Changes**: [v2.34.0-beta.1...v2.34.0](https://github.com/n24q02m/better-notion-mcp/compare/v2.34.0-beta.1...v2.34.0) |
| `v2.33.0` | 2026-05-09 | High | ## v2.33.0 (2026-05-09)  ---  **Detailed Changes**: [v2.33.0-beta.1...v2.33.0](https://github.com/n24q02m/better-notion-mcp/compare/v2.33.0-beta.1...v2.33.0) |
| `v2.31.0` | 2026-05-04 | High | ## v2.31.0 (2026-05-04)  ### Bug Fixes  - Bump mcp-core to 1.13.0 (STABLE) ([#644](https://github.com/n24q02m/better-notion-mcp/pull/644), [`931c1f3`](https://github.com/n24q02m/better-notion-mcp/commit/931c1f347aaa6b9c8f787f7a7b7f7d3fde753221))  ---  **Detailed Changes**: [v2.31.0-beta.6...v2.31.0](https://github.com/n24q02m/better-notion-mcp/compare/v2.31.0-beta.6...v2.31.0) |
| `v2.30.6` | 2026-04-29 | High | ## v2.30.6 (2026-04-29)  ### Bug Fixes  - Rebuild against mcp-core 1.11.5 fork-bomb fix ([#620](https://github.com/n24q02m/better-notion-mcp/pull/620), [`b1bf88a`](https://github.com/n24q02m/better-notion-mcp/commit/b1bf88a7939e9cd94746d50c9c71ff75ce505216))  ---  **Detailed Changes**: [v2.30.5...v2.30.6](https://github.com/n24q02m/better-notion-mcp/compare/v2.30.5...v2.30.6) |
| `v2.29.1` | 2026-04-24 | High | ## v2.29.1 (2026-04-24)  ### Bug Fixes  - Bump @n24q02m/mcp-core to 1.7.6 ([#591](https://github.com/n24q02m/better-notion-mcp/pull/591), [`ccc2c71`](https://github.com/n24q02m/better-notion-mcp/commit/ccc2c71ebbb7b2be5b42d7013032a02270fefaa0))  ---  **Detailed Changes**: [v2.29.0...v2.29.1](https://github.com/n24q02m/better-notion-mcp/compare/v2.29.0...v2.29.1) |
| `v2.28.6` | 2026-04-22 | High | ## v2.28.6 (2026-04-22)  ### Bug Fixes  - Bump @n24q02m/mcp-core to 1.5.1 ([`2a8a5bf`](https://github.com/n24q02m/better-notion-mcp/commit/2a8a5bfa25ce0f20f988dbfd0002bdfcfc70f69e))  - Bump @n24q02m/mcp-core to 1.6.1 ([#571](https://github.com/n24q02m/better-notion-mcp/pull/571), [`dfe028c`](https://github.com/n24q02m/better-notion-mcp/commit/dfe028cd04f286c01af5254e3693eccc2ed59e8e))  - Refresh bun.lock after non-major bumps ([#567](https://github.com/n24q02m/better-notion-mcp/pull/567), [`e32c |
| `v2.28.5` | 2026-04-21 | High | ## v2.28.5 (2026-04-21)  ### Bug Fixes  - Bump actions/setup-node digest to 48b55a0 ([`070534a`](https://github.com/n24q02m/better-notion-mcp/commit/070534ac6eb47e97be51eb5545524438c54fc013))  - Bump oven/bun:1-alpine docker digest to 4de4753 ([`65684e9`](https://github.com/n24q02m/better-notion-mcp/commit/65684e99590328752c2299f5396839ec061a000a))  - Bump step-security/harden-runner digest to 8d3c67d ([`8f11d19`](https://github.com/n24q02m/better-notion-mcp/commit/8f11d198182c01c70e195f8f1c85cf |
| `v2.28.4` | 2026-04-21 | High | ## v2.28.4 (2026-04-21)  ### Bug Fixes  - Persist token + notify relay safely in local-relay mode ([`1d5b2d9`](https://github.com/n24q02m/better-notion-mcp/commit/1d5b2d9e5742e29908d495bd5ac412f2fb30386b))  - Prevent command injection in tryOpenBrowser via URL safety validator ([`a798afe`](https://github.com/n24q02m/better-notion-mcp/commit/a798afec8c9b6de7b91e1e96ba3990fff3e1fae6))  - Stdio fallback spawns local HTTP, never hits remote URL ([`df721e0`](https://github.com/n24q02m/better-notion-m |
| `v2.28.3` | 2026-04-20 | High | ## v2.28.3 (2026-04-20)  ### Bug Fixes  - Bump @n24q02m/mcp-core to ^1.4.2 ([#558](https://github.com/n24q02m/better-notion-mcp/pull/558), [`10ba266`](https://github.com/n24q02m/better-notion-mcp/commit/10ba2660d7048548e3138abbee043aa59d547338))  ---  **Detailed Changes**: [v2.28.2...v2.28.3](https://github.com/n24q02m/better-notion-mcp/compare/v2.28.2...v2.28.3) |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 11
- **Resolved**: 11
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-25

## Citation

- HTML: https://www.freshcrate.ai/projects/better-notion-mcp
- Markdown: https://www.freshcrate.ai/projects/better-notion-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/better-notion-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._