← Back to Notion Remote

Install Notion Remote

Pick your client, copy the command, done.

other
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

npm install
npm run start
2

Register it in Claude Code

claude mcp add -e "TOKEN_ENC_KEY=${TOKEN_ENC_KEY}" -e "STATE_SIGNING_KEY=${STATE_SIGNING_KEY}" -e "NOTION_CLIENT_ID=${NOTION_CLIENT_ID}" -e "NOTION_CLIENT_SECRET=${NOTION_CLIENT_SECRET}" notion-remote -- node /path/to/server.js

Replace any placeholder paths in the command with the real path on your machine.

Required:TOKEN_ENC_KEYSTATE_SIGNING_KEYNOTION_CLIENT_IDNOTION_CLIENT_SECRET

Environment Variables

Set these before running Notion Remote.

VariableDescriptionRequired
TOKEN_ENC_KEYBase64 encoded encryption key for tokensYes
STATE_SIGNING_KEYSecret key for signing OAuth stateYes
NOTION_CLIENT_IDNotion integration client IDYes
NOTION_CLIENT_SECRETNotion integration client secretYes

Available Tools (9)

Once configured, Notion Remote gives your AI agent access to:

notion.searchSearch pages and databases in Notion
queryfiltersortpage_sizestart_cursor
notion.get_pageRetrieve a specific Notion page
page_idinclude_properties
notion.get_databaseRetrieve a database or data source
database_id
notion.query_databaseQuery database rows
database_idfiltersortpage_sizestart_cursor
notion.create_pageCreate a new page in Notion
parentpropertieschildren
notion.update_pageUpdate properties of an existing page
page_idproperties
notion.append_blockAppend blocks to a page
block_idchildren
notion.list_usersList users in the workspace
notion.whoamiGet integration identity information

Try It Out

After setup, try these prompts with your AI agent:

→Search for my recent project meeting notes in Notion.
→Query the 'Tasks' database to find all items assigned to me with status 'In Progress'.
→Create a new page titled 'Weekly Summary' in my 'Work' database.
→Append a new checklist item to the page with ID '12345'.
→Who is the current integration user for this Notion connection?
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • TOKEN_ENC_KEY — Base64 encoded encryption key for tokens
  • STATE_SIGNING_KEY — Secret key for signing OAuth state
  • NOTION_CLIENT_ID — Notion integration client ID
  • NOTION_CLIENT_SECRET — Notion integration client secret

Keep this setup from going cold

Save the docs, env vars, and workflow around Notion Remote in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← Notion Remote overview Browse other servers →