Noeto MCP server

noeto-mcp

An MCP server that lets an AI agent work a noeto kanban board: read it, create and update cards, move them, comment, and keep a written document on a card.

Quick start (Claude Code)

1. In noeto, Settings → Access tokens → Create token, and copy the secret.
2. Install the plugin. It bundles the server and the /card workflow:

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

1. Export the token and restart Claude Code:

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

Then ask: "What's on my board?" More in the plugin README.

Other ways to run it

Docker, for any MCP host:

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.4

Or by hand in ~/.claude.json, .mcp.json or Claude Desktop's config:

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

Native binary, with 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"

Or take an archive from releases (macOS, Linux, Windows). The binary is unsigned, so on macOS run xattr -d com.apple.quarantine noeto-mcp first. Point the config at it by absolute path.

Good to know

entries with their own tokens (noeto-work, noeto-personal).

• One server serves one team — the token decides which. For two teams, add two

(macOS, Windows) or --network host (Linux).

• Against a local noeto from Docker, use http://host.docker.internal:8081/api/v1

in claude.ai in the browser or the mobile apps.

• It runs as a local process, so it works in Claude Code and Claude Desktop, not

Tools

Shortened. The full README is on GitHub.