Updated April 2026

Install GetNote MCP Server

Pick your client, copy the command, done.

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "GETNOTE_API_KEY=${GETNOTE_API_KEY}" -e "GETNOTE_CLIENT_ID=${GETNOTE_CLIENT_ID}" getnote-mcp -- node "<FULL_PATH_TO_GETNOTE_MCP>/dist/index.js"

Replace <FULL_PATH_TO_GETNOTE_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:GETNOTE_API_KEYGETNOTE_CLIENT_ID

Environment Variables

Set these before running GetNote MCP Server.

VariableDescriptionRequired
GETNOTE_API_KEYAPI Key from Get笔记 Open APIYes
GETNOTE_CLIENT_IDClient ID from Get笔记 Open APIYes

Available Tools (21)

Once configured, GetNote MCP Server gives your AI agent access to:

list_notesGet a list of notes using cursor pagination.
get_noteRetrieve details of a specific note.
save_noteCreate a new note (plain text, link, or image).
get_note_task_progressCheck the creation progress of a link-based note.
delete_noteMove a note to the trash.
add_note_tagsAdd tags to a note.
delete_note_tagRemove tags from a note.
list_topicsGet a list of knowledge bases.
create_topicCreate a new knowledge base.
list_topic_notesGet a list of notes within a knowledge base.
batch_add_notes_to_topicAdd multiple notes to a knowledge base.
remove_note_from_topicRemove a note from a knowledge base.
get_upload_configGet image upload configuration.
get_upload_tokenGet a pre-signed URL for image uploads.
upload_imageUpload an image to OSS.
list_topic_bloggersGet a list of bloggers subscribed to a knowledge base.
list_topic_blogger_contentsGet a list of content summaries from a blogger.
get_blogger_content_detailGet detailed content from a blogger including original text.
list_topic_livesGet a list of completed live streams in a knowledge base.
get_live_detailGet details of a live stream including AI summary and transcript.
get_quotaCheck API usage quota.

Try It Out

After setup, try these prompts with your AI agent:

→Save this link as a new note in my GetNote account.
→List the notes in my 'Project Ideas' knowledge base.
→Add the tag 'research' to my most recent note.
→Find the summary of the latest live stream in my 'Tech Talks' knowledge base.
→Create a new knowledge base called 'AI Experiments'.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • GETNOTE_API_KEY — API Key from Get笔记 Open API
  • GETNOTE_CLIENT_ID — Client ID from Get笔记 Open API

Keep this setup from going cold

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

Need the legacy visual installer? Open Conare IDE.
Remember this setup
← GetNote MCP Server overview Browse file-management servers →