Noeto

Name: Noeto
Author: noeto-tasks

本地服务

noeto.online生产力04 周前更新

代码仓库访问官网

关于 Noeto

Noeto 是供 AI Agent 操作 Noeto 看板的 MCP 服务，支持查看和搜索看板、更新卡片、评论及管理文档和附件，并禁止删除用户创建的内容。

主要功能

01列出看板并查看列与卡片
02按文本和属性搜索卡片
03创建、更新和移动卡片
04评论卡片
05读取并附加卡片文档
06读取或下载附件

适用场景

01按负责人、标签或到期日查找卡片
02移动卡片并更新详情
03为卡片添加评论或文档
04获取卡片附件

MCP 相关

本地 MCP 服务为一个 Noeto 团队提供读写工具，团队由访问令牌决定。它可通过 Docker 或原生二进制运行，并连接 Claude Code、Claude Desktop 和其他 MCP 主机。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "noeto-tasks-noeto": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "NOETO_TOKEN",
        "-e",
        "NOETO_API_URL",
        "ghcr.io/noeto-tasks/noeto-mcp:v0.6.5"
      ],
      "env": {
        "NOETO_TOKEN": "<NOETO_TOKEN>",
        "NOETO_API_URL": "<NOETO_API_URL>"
      }
    }
  }
}

启动命令docker run -i --rm -e NOETO_TOKEN -e NOETO_API_URL ghcr.io/noeto-tasks/noeto-mcp:v0.6.5

需要配置的环境变量

NOETO_TOKEN密钥Personal access token, from Settings → Access tokens in Noeto. It decides which team the server works.

NOETO_API_URLThe Noeto API root.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocighcr.io/noeto-tasks/noeto-mcp:v0.6.5stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

noeto-mcp

一个 MCP 服务，可让 AI Agent 操作 noeto 看板：读取看板、创建和更新卡片、移动卡片、发表评论，以及在卡片上保存文档。

Claude Code 创建了一个 Bug 卡片，将一张卡片移至进行中并评论计划，同时旁边的 noeto 看板也随之更新

快速开始（Claude Code）

在 noeto 中，前往 设置 → 访问令牌 → 创建令牌，然后复制密钥。

安装插件。插件包含该服务和 /card 工作流：

/plugin marketplace add noeto-tasks/noeto-mcp
/plugin install noeto@noeto-mcp

导出令牌并重启 Claude Code：

export NOETO_TOKEN=noeto_pat_…
export NOETO_API_URL=https://api.noeto.online/api/v1

然后提问：“我的看板上有什么？” 更多信息请参阅插件 README。

其他运行方式

Docker，适用于任何 MCP 主机：

claude mcp add noeto -s user \
  -e NOETO_TOKEN=noeto_pat_… \
  -e NOETO_API_URL=https://api.noeto.online/api/v1 \
  -- docker run -i --rm -e NOETO_TOKEN -e NOETO_API_URL ghcr.io/noeto-tasks/noeto-mcp:v0.6.5

也可以手动添加到 ~/.claude.json、.mcp.json 或 Claude Desktop 的配置中：

{
  "mcpServers": {
    "noeto": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "NOETO_TOKEN", "-e", "NOETO_API_URL",
               "ghcr.io/noeto-tasks/noeto-mcp:v0.6.5"],
      "env": {
        "NOETO_TOKEN": "noeto_pat_…",
        "NOETO_API_URL": "https://api.noeto.online/api/v1"
      }
    }
  }
}

原生二进制文件，使用 Homebrew：

brew install noeto-tasks/tap/noeto-mcp
claude mcp add noeto -s user \
  -e NOETO_TOKEN=noeto_pat_… \
  -e NOETO_API_URL=https://api.noeto.online/api/v1 \
  -- "$(brew --prefix)/bin/noeto-mcp"

或者从发布页面下载压缩包（macOS、Linux、Windows）。该二进制文件未签名，因此在 macOS 上请先运行 xattr -d com.apple.quarantine noeto-mcp。在配置中使用其绝对路径。

须知

一个服务对应一个团队——令牌决定服务关联的团队。若要连接两个团队，请添加两个使用各自令牌的条目（noeto-work、noeto-personal）。
若要连接 Docker 中运行的本地 noeto，请使用 http://host.docker.internal:8081/api/v1 （macOS、Windows），或使用 --network host（Linux）。
它以本地进程的方式运行，因此可在 Claude Code 和 Claude Desktop 中使用，但不能在浏览器中的 claude.ai 或移动应用中使用。

工具

工具	功能
`list_boards`	列出团队的看板及卡片数量	读取
`get_board`	获取一个看板：按顺序排列的列及其中的卡片	读取
`find_cards`	按文本、负责人、标签、优先级、列和截止日期搜索所有看板	读取
`get_card`	获取一张卡片的完整信息，包括评论和文件	读取
`list_members`	列出团队成员	读取
`whoami`	查看令牌所属的成员	读取
`create_card`	在某一列中添加卡片	写入
`update_card`	更新标题、描述、负责人、优先级、截止日期和标签	写入
`move_card`	将卡片移至其他列，或在同一列中重新排序	写入
`comment_on_card`	发布评论	写入
`read_document`	读取卡片上文档的 Markdown 内容	读取
`attach_document`	写入文档，并替换同名文档的现有版本	替换
`read_attachment`	读取卡片上的文本或图像文件	读取
`download_attachment`	将卡片上的任意文件保存到磁盘并返回其路径	本地保存

看板、列、标签和人员都可以通过名称指定：move_card(card, column: "Done")。卡片本身必须使用 ID，因此即使输错名称，也绝不会修改错误的卡片。
none 会清除字段：update_card(card, due: "none")。省略参数则保持原值。
文档和文本文件的大小上限为 512 KB，图像为 1.5 MB。更大的文件和其他类型的文件请使用 download_attachment。
下载的文件会保存到 NOETO_DOWNLOAD_DIR（默认值：系统临时目录中的 noeto-attachments）。在 Docker 中，请将该目录挂载到容器内外的相同路径——插件的配置已完成此设置。

它刻意无法删除任何由人员创建的内容，也不会创建看板、列或标签。关于这些及其他设计选择的原因，请参阅 docs/internals.md。

开发

make test         # hermetic, against a fake API
make smoke        # contract check against a running noeto (needs NOETO_TOKEN)
make lint
make docker       # build the image for this machine
make release-dry  # build release artifacts into dist/, publish nothing

任何 API 变更后都要运行 make smoke。

发布： Actions → Release → Run workflow，并填写版本号（0.6.3）。该流程会运行测试、固定版本、推送镜像、打标签、发布 GitHub release 和 Homebrew cask，并在 MCP Registry 中列出该版本。它需要一个 HOMEBREW_TAP_TOKEN 密钥，以便写入 noeto-tasks/homebrew-tap。 make release-plugin RELEASE=x.y.z 可在笔记本电脑上执行相同操作，但不会发布到 Registry：之后请运行 Publish to MCP Registry 工作流。