A maintained fork of the official Notion MCP server
A maintained fork of the official Notion MCP server. Exposed over MCP by the notion mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.
If you have hardcoded tool names or prompts that reference the old database tools, update them to use the new data source tools:
Everything the assistant can do here goes through one of these:
post-database-query — replaced by query-data-sourceupdate-a-database — replaced by update-a-data-sourcecreate-a-database — replaced by create-a-data-sourcequery-data-source — Query a data source (database) with filters and sortsretrieve-a-data-source — Get metadata and schema for a data sourceupdate-a-data-source — Update data source propertiescreate-a-data-source — Create a new data sourcelist-data-source-templates — List available templates in a data sourcemove-page — Move a page to a different parent locationretrieve-a-database — Get database metadata including its data source IDsInstallation — The Installation tool exposed by this serverExamples — AI will correctly plan two API calls, v1/search and v1/comments, to achieve the taskYou will need 3 environment variables: NOTION_TOKEN, OPENAPI_MCP_HEADERS, AUTH_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
The server ships on npm as @notionhq/notion-mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Notion's toolset — post-database-query, update-a-database, create-a-database and 11 more — is a fair guide to whether it matches your workflow. It is maintained by mieubrisse; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| post-database-query | replaced by query-data-source |
| update-a-database | replaced by update-a-data-source |
| create-a-database | replaced by create-a-data-source |
| query-data-source | Query a data source (database) with filters and sorts |
| retrieve-a-data-source | Get metadata and schema for a data source |
| update-a-data-source | Update data source properties |
| create-a-data-source | Create a new data source |
| list-data-source-templates | List available templates in a data source |
| move-page | Move a page to a different parent location |
| retrieve-a-database | Get database metadata including its data source IDs |
| Installation | The Installation tool exposed by this server. |
| Examples | AI will correctly plan two API calls, v1/search and v1/comments, to achieve the task |
| Development | The Development tool exposed by this server. |
| Execute | 1. Run npm link command from repository root to create a machine-global symlink to the notion-mcp-server package. 2. Merge the configuration snippet below into Cursor's mcp.json (or other MCP client you want to test with |
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_****"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| NOTION_TOKEN | Credential the server authenticates with. | Yes |
| OPENAPI_MCP_HEADERS | Configuration value read at startup. | Optional |
| AUTH_TOKEN | Credential the server authenticates with. | Yes |
Read-only SQL access to Postgres — let your assistant inspect schemas and answer questions from real data.
Manage your whole Supabase project in conversation — database, auth, storage, Edge Functions and branches.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.
Serverless Postgres with database branching — point your assistant at Neon and let it work on disposable copies.