1. Home
  2. Notion MCP Server
  3. Notion MCP Server for VS Code: Setup & Config

Data as of

Notion MCP Server for VS Code: Setup & Config

Connect VS Code to the Notion API to work with pages and data sources.

Notion MCP Server 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 notion-mcp-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.

Config file · Workspace: .vscode/mcp.json

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

Notion in VS Code: stdio checks

  • Make npx @notionhq/notion-mcp-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_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.
Tools
query-data-source, retrieve-a-data-source, update-a-data-source

Notion MCP Server — details. VS Code guide

Frequently asked questions

For Notion MCP Server, edit workspace .vscode/mcp.json. VS Code requires servers rather than mcpServers; preserve the displayed type on each entry.

VS Code's notion-mcp-server example uses stdio.

Notion MCP Server's VS Code configuration invokes npx @notionhq/notion-mcp-server (Node.js/npm).

VS Code's Notion MCP Server example references NOTION_TOKEN. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

Notion MCP Server's stored list contains 9 tools, including query-data-source, retrieve-a-data-source, update-a-data-source. Compare those names with VS Code's connected tool list; the stored list is not a live check.