quillink-mcp

一个 MCP 服务器，向 Claude Desktop、Claude Code 以及其他兼容 MCP 的客户端等 AI 工具提供对您的 Quillink 笔记、文件夹和标签的只读访问。

需要 Pro 版 Quillink 计划（API 访问是仅限 Pro 的功能）。

未发布到 PyPI —— 请从源代码本地构建并运行。

构建

git clone https://github.com/dagistankaradeniz/gcp-note-taking-mcp.git
cd gcp-note-taking-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

这会将 quillink-mcp 命令安装到 .venv/bin/ 中。请注意该二进制的完整路径（例如 /Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp）—— MCP 客户端直接启动它，而不是通过激活的 shell，因此它们需要绝对路径。

Related MCP server: Bruin

身份验证

两种选项：

选项 A — OAuth 设备登录（推荐用于交互式使用）：

.venv/bin/quillink-mcp login

打开设备代码 + 验证 URL；在浏览器中批准。令牌存储在您的操作系统密钥环中（或回退到 ~/.config/quillink-mcp/credential）。

选项 B — 个人访问令牌：

在 Quillink 的 设置 → 开发者 → 令牌 下创建一个（作用域：notes:read、folders:read、tags:read），然后将其设置为环境变量：

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKEN 始终优先于已存储的 OAuth 登录。

与 Claude Desktop 一起使用

添加到您的 Claude Desktop 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp"
    }
  }
}

如果使用 PAT 而不是 login，请在配置中将其作为环境变量传递：

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp",
      "env": { "QUILLINK_TOKEN": "qlk_pat_..." }
    }
  }
}

编辑配置后重启 Claude Desktop。

与其他 MCP 客户端一起使用

任何能够启动本地 stdio MCP 服务器的客户端都可以以相同方式工作：将其指向 .venv/bin/quillink-mcp 的绝对路径（设置 QUILLINK_TOKEN，或运行一次 quillink-mcp login 以便凭据已存储）。这包括 Claude Code（claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp）以及任何支持 MCP stdio 传输的 OpenAI 兼容代理运行时。

工具

全部只读 —— 此服务器无法创建、编辑或删除任何内容。

Vault 笔记在此处永远无法访问——它们在客户端进行端到端加密，因此任何服务器（包括此服务器）都无法读取它们。对于不在团队计划组织中的调用者，组织工具会返回 404。

配置（环境变量）

直接运行（用于测试）

.venv/bin/quillink-mcp login
.venv/bin/quillink-mcp   # runs the server on stdio -- an MCP client normally launches this for you