getnote-mcp

MCP (Model Context Protocol) server for Get笔记 Open API.

Get笔记是一款个人笔记管理工具。通过此 MCP Server，AI 模型可以帮助用户管理笔记。

使用场景

用户说「帮我记一下」「保存到笔记」「记录下来」→ save_note
用户说「查一下我的笔记」「找找之前的笔记」→ list_notes
用户分享了一个链接，说「保存这个」→ save_note（链接笔记）
用户说「给这个笔记加个标签」→ add_note_tags

Features

Exposes the following tools to AI models:

Tool	Description
`list_notes`	获取笔记列表（游标分页）
`get_note`	获取笔记详情
`save_note`	新建笔记（纯文本/链接，见下方类型限制）
`get_note_task_progress`	查询创建笔记任务进度（链接笔记）
`delete_note`	删除笔记（移入回收站）
`add_note_tags`	添加笔记标签
`delete_note_tag`	删除笔记标签
`list_topics`	获取知识库列表
`create_topic`	创建知识库
`list_topic_notes`	获取知识库笔记列表
`batch_add_notes_to_topic`	批量添加笔记到知识库
`remove_note_from_topic`	从知识库移除笔记
`get_upload_config`	获取图片上传配置
`get_upload_token`	获取图片上传凭证（预签名 URL）
`upload_image`	完整图片上传（自动获取凭证 + 上传到 OSS）
`get_quota`	查询 API 调用配额

Installation

npm install
npm run build

Usage

⚠️ API Key 配置（重要）

为确保每次启动都能正常使用，请将 API Key 保存到持久化配置中：

环境变量（推荐）：添加到 shell 配置文件（如 ~/.zshrc）
MCP 配置文件：添加到 Claude Desktop 或其他 MCP 客户端的配置
项目 .env 文件：在项目目录创建 .env 文件

Environment variable

# 临时使用
GETNOTE_API_KEY=your_api_key node dist/index.js

# 持久化（添加到 ~/.zshrc 或 ~/.bashrc）
export GETNOTE_API_KEY=gk_live_xxx

CLI flag

node dist/index.js --api-key your_api_key

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "getnote": {
      "command": "node",
      "args": ["/path/to/getnote-mcp/dist/index.js"],
      "env": {
        "GETNOTE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Limits

Item	Limit
每日知识库创建上限	每个账号每天最多创建 50 个知识库
重置时间	按 Europe/Berlin 时区自然日 00:00 重置

⚠️ 超出限制时，create_topic 接口将返回 429 错误（reason: quota_day）。

Notes on Note Types

save_note currently supports two note types only:

Type	Description
`plain_text`	纯文本笔记（默认）
`link`	链接笔记（需传 `link_url`）

⚠️ 限制说明：图片笔记、语音笔记等其他类型只能在 Get笔记 App 或 Web 端创建，MCP 工具可以通过 get_note / list_notes 读取这些笔记，但无法通过 MCP 创建。

API

Base URL: https://open.getnotes.cn/api/v1
Auth: Bearer Token (API Key)

Get your API Key at Get笔记开放平台.

License

MIT

GetNote MCP Server