← Back to GetNote MCP Server

Install GetNote MCP Server

Pick your client, copy the command, done.

file-management
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 build
2

Register it in Claude Code

claude mcp add -e "GETNOTE_API_KEY=${GETNOTE_API_KEY}" -e "GETNOTE_CLIENT_ID=${GETNOTE_CLIENT_ID}" getnote-mcp -- node /path/to/getnote-mcp/dist/index.js

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

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.

Remember this setup
← GetNote MCP Server overview Browse file-management servers →