Notion MCP Server for VS Code: Setup & Config

What you can do with Notion in VS Code

Pick it for compact Notion context and schema-aware editing without relying on raw API JSON for routine work.

• Query Notion data sources using schema-aware filters
• Append Markdown or batch-edit common page blocks
• Create data source items from simple property values

Before you start: Notion in VS Code

• npx
• An MCP host
• A Notion internal integration token
• Content shared with the integration and appropriate capabilities

Restart the MCP host after configuration. Grant only needed capabilities and share target pages or databases with the integration. Development prerequisites specify Node.js 22 or newer and pnpm.

Notion VS Code configuration

1. Choose VS Code configuration scope

   For Notion MCP Server, open Workspace: .vscode/mcp.json. Merge into servers; preserve existing inputs.

2. Add Notion MCP Server to VS Code

   Use the mcp-notion-server entry below in servers. Keep Notion MCP Server's documented stdio connection fields and your other VS Code entries.

3. Check Notion MCP Server in VS Code

   Notion MCP Server: Start in VS Code’s MCP controls; inspect output and trust prompts.

{
  "servers": {
    "mcp-notion-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "<Notion internal integration token>"
      }
    }
  }
}

Notion tools available to VS Code

Notion's stored tool list documents 31 tools; compare it with VS Code's connected tool list, because the stored list is not a live check.

notion_open_data_source_app

Look for notion_open_data_source_app among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_open_page_workbench

Look for notion_open_page_workbench among VS Code's agent-mode tools after starting Notion through the MCP controls.

Open an interactive app for page reading, block selection, simple edits, and Markdown append.

notion_append_block_children

Look for notion_append_block_children among VS Code's agent-mode tools after starting Notion through the MCP controls.

Insert child blocks beneath a parent at a specified position.

notion_append_content

Look for notion_append_content among VS Code's agent-mode tools after starting Notion through the MCP controls.

Append common content types without constructing raw block JSON.

notion_append_markdown

Look for notion_append_markdown among VS Code's agent-mode tools after starting Notion through the MCP controls.

Append supported Markdown elements as Notion blocks.

notion_update_content

Look for notion_update_content among VS Code's agent-mode tools after starting Notion through the MCP controls.

Replace simple content fields on an existing block of the matching type.

notion_update_content_batch

Look for notion_update_content_batch among VS Code's agent-mode tools after starting Notion through the MCP controls.

Validate target block types and apply several simple content updates.

notion_retrieve_block

Look for notion_retrieve_block among VS Code's agent-mode tools after starting Notion through the MCP controls.

Fetch a single Notion block.

notion_retrieve_block_children

Look for notion_retrieve_block_children among VS Code's agent-mode tools after starting Notion through the MCP controls.

Fetch blocks nested beneath a parent.

notion_delete_block

Look for notion_delete_block among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_update_block

Look for notion_update_block among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_retrieve_page

Look for notion_retrieve_page among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_read_page

Look for notion_read_page among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_update_page_properties

Look for notion_update_page_properties among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_list_all_users

Look for notion_list_all_users among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_retrieve_user

Look for notion_retrieve_user among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_retrieve_bot_user

Look for notion_retrieve_bot_user among VS Code's agent-mode tools after starting Notion through the MCP controls.

Inspect the bot identity associated with the token.

notion_retrieve_database

Look for notion_retrieve_database among VS Code's agent-mode tools after starting Notion through the MCP controls.

Inspect a database container and discover its child data sources.

notion_create_database

Look for notion_create_database among VS Code's agent-mode tools after starting Notion through the MCP controls.

Create a database and its initial data source schema.

notion_create_data_source

Look for notion_create_data_source among VS Code's agent-mode tools after starting Notion through the MCP controls.

Add another data source to an existing database.

notion_query_data_source

Look for notion_query_data_source among VS Code's agent-mode tools after starting Notion through the MCP controls.

Query a data source with filters, ordering, and pagination.

notion_query_data_source_by_values

Look for notion_query_data_source_by_values among VS Code's agent-mode tools after starting Notion through the MCP controls.

Query using schema-aware simple filters and sort values.

notion_retrieve_data_source

Look for notion_retrieve_data_source among VS Code's agent-mode tools after starting Notion through the MCP controls.

Fetch data source metadata and property definitions.

notion_update_data_source

Look for notion_update_data_source among VS Code's agent-mode tools after starting Notion through the MCP controls.

Change a data source title, description, or schema.

notion_create_data_source_item

Look for notion_create_data_source_item among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_create_data_source_item_from_values

Look for notion_create_data_source_item_from_values among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_create_comment

Look for notion_create_comment among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_retrieve_comments

Look for notion_retrieve_comments among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_find

Look for notion_find among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_inspect_data_source

Look for notion_inspect_data_source among VS Code's agent-mode tools after starting Notion through the MCP controls.

notion_search

Look for notion_search among VS Code's agent-mode tools after starting Notion through the MCP controls.

Notion: full stored tool descriptions

Troubleshooting Notion in VS Code

• Make npx @suekou/mcp-notion-server (Node.js/npm) available in the workspace, container, or remote environment hosting Notion MCP Server. Start through VS Code's MCP controls; inspect output and trust prompts.
• For Notion MCP Server, keep NOTION_API_TOKEN out of version control; VS Code documents input variables and secret handling.
• Notion MCP Server uses stdio here: VS Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Only shared content and granted capabilities are accessible
• Known limitation: Some user lookup tools require Enterprise and an Organization API key
• Known limitation: Markdown append supports a limited safe subset
• General VS Code troubleshooting lives in the /clients/vscode guide.

Frequently asked questions