Connect Notion to Cursor
Read and update pages, databases, and team knowledge. Add Toolspoke to Cursor once and it can use 17 Notion actions. Your Notion credential stays in Toolspoke, and you choose which actions Cursor may call.
Set it up in Cursor
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Cursor
~/.cursor/mcp.json, or .cursor/mcp.json for one project
{ "mcpServers": { "toolspoke": { "url": "https://toolspoke.com/mcp" } } }Cursor completes the sign-in in a browser tab the first time it connects.
Install Notion and connect it
Add Notion to a project in your Toolspoke workspace.
Press connect and sign in to Notion. Toolspoke keeps the token encrypted and refreshes it when it expires, so there is nothing to copy and nothing to rotate by hand.
Choose what Cursor may do
All 17 actions start on. Switch off any of the 9 actions that change something in Notion, and Cursor gets a refusal if it tries.
What you can ask Cursor for
A few of the Notion actions that only read, so they are safe to try first.
- Search Notion and any connected sources (Slack, Drive, GitHub, Jira, Linear) and return ranked results to read
- Retrieve a Notion page, database, or data source in full by id or URL
- Query database rows with read-only SQLite against one or more data sources
- Return the rows of a database view with its own filters and sorts already applied
What Cursor can do in Notion
8 actions read and 9 write.
Reads
Notion search
Search Notion and any connected sources (Slack, Drive, GitHub, Jira, Linear) and return ranked results to read. Start here when you do not already have a page id, then call notion-fetch on the ids you want in full. Set query_type to "user" to look people up by name or email.
Notion fetch
Retrieve a Notion page, database, or data source in full by id or URL. Pages come back as Notion-flavored Markdown; databases list their data sources with collection:// ids you need for querying. Pass the id "self" to identify the connected workspace and user.
Notion query data sources
Query database rows with read-only SQLite against one or more data sources. Call notion-fetch on the database first to get its collection:// URLs and schema, then use those URLs as table names. Use parameters rather than string interpolation; checkboxes compare against "__YES__" and "__NO__".
Notion query database view
Return the rows of a database view with its own filters and sorts already applied. Use this when the workspace already has the view you want; use notion-query-data-sources when you need custom SQL or aggregation.
Notion get comments
Read the discussions on a page, with their full comment text. Returns page-level threads by default; set include_all_blocks for inline comments and include_resolved to see closed ones.
Notion get teams
List the teamspaces in this workspace with their ids, names, and whether the connected user is a member. Use it to get the teamspace_id that narrows notion-search.
Notion get users
List or search workspace members and guests, returning their ids, names, and emails. Use it to resolve a person's name to the user id that People properties and user mentions need. Pass user_id "self" for the connected user.
Notion get async task
Poll a background task started by notion-create-pages, notion-update-page, or another tool called with allow_async. Status is queued, running, retrying, succeeded, or failed; the result or error arrives once it finishes. Wait a few seconds between polls.
Writes
Notion create pages
Create one or more Notion pages under a shared parent. When the parent is a database, call notion-fetch on it first to learn its schema and exact property names. Content is Notion-flavored Markdown and must not repeat the title.
Notion update page
Update one page's properties or content. Pick the narrowest command: update_properties for fields, update_content for search-and-replace edits, insert_content to prepend or append, replace_content only to rewrite the whole page. Fetch the page first so old_str matches exactly.
Notion move pages
Move up to 100 pages or databases under a new parent. Use it to file loose pages into a teamspace page or a database. Data sources under a database cannot be moved on their own.
Notion duplicate page
Duplicate a page inside the same workspace. The copy is created asynchronously, so the returned id may not be populated immediately, re-read it with notion-fetch if you need its contents.
Notion create database
Create a database from a SQL-style CREATE TABLE schema, or from one of Notion's canonical types (tasks, projects, skills). Returns the new data source id needed by notion-query-data-sources and notion-update-data-source. Provide exactly one of schema or database_type.
Notion update data source
Change a data source's schema, title, or description with SQL DDL. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET. DROP COLUMN removes a property and its values, and in_trash moves the whole data source to the trash, use both deliberately.
Notion create view
Add a view to a database, or embed a linked view of it on another page. Supply database_id to add a tab, or parent_page_id to append an inline linked view. Filters, sorts, and grouping come from the configure DSL. A form view alone is not a usable form; this toolkit cannot configure form questions or publish/share the form. Those steps must be completed manually in Notion.
Notion update view
Rename a view or change its filters, sorts, grouping, and visible properties. Only send the fields you want to change; CLEAR FILTER, CLEAR SORT, and CLEAR GROUP BY remove existing settings.
Notion create comment
Add a comment to a page, to a specific passage on it, or as a reply in an existing thread. Pass page_id alone for a page-level comment, add selection_with_ellipsis to anchor it to content, or pass discussion_id to reply.
Notion in Cursor: questions
Does Cursor see my Notion credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Cursor only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Cursor from changing things in Notion?
Yes. Each of the 17 actions can be switched off for a project. Turn off the 9 that change something and Cursor can only read.
Will 17 actions crowd Cursor's context?
No. Toolspoke shows Cursor five bridge tools, plus a guide where a toolkit has one, and Cursor searches for the Notion action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Should it go in every project or just one?
Either. Put the block in ~/.cursor/mcp.json to have Toolspoke in every project, or in .cursor/mcp.json inside one project to keep it there.
What does it cost?
Tool calls are free on every plan, and a Notion call does not run in a sandbox, so it bills nothing.
Try Notion in Cursor
Free to start, and tool calls cost nothing on any plan.