Connect Notion to VS Code

Read and update pages, databases, and team knowledge. Add Toolspoke to VS Code once and it can use 17 Notion actions. Your Notion credential stays in Toolspoke, and you choose which actions VS Code may call.

Set it up in VS Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to VS Code

    .vscode/mcp.json, or the MCP: Add Server command

    { "servers": { "toolspoke": { "type": "http", "url": "https://toolspoke.com/mcp" } } }

    Approve the authorization request when VS Code opens it.

  2. 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.

  3. Choose what VS Code may do

    All 17 actions start on. Switch off any of the 9 actions that change something in Notion, and VS Code gets a refusal if it tries.

What you can ask VS Code 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 VS Code 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 VS Code: questions

Does VS Code see my Notion credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. VS Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop VS Code 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 VS Code can only read.

Will 17 actions crowd VS Code's context?

No. Toolspoke shows VS Code five bridge tools, plus a guide where a toolkit has one, and VS Code searches for the Notion action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Where do the tools show up in VS Code?

In chat, in agent mode, which is where VS Code uses MCP servers. Add the block to .vscode/mcp.json for one workspace, or use the MCP: Add Server command.

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 VS Code

Free to start, and tool calls cost nothing on any plan.