PlugWiki
kaneo logo

Kaneo MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialLocal
Getnpm@kaneo/mcpusekaneo/kaneo

Lets Claude, Cursor and other assistants manage your Kaneo project board: find, create and update tasks, comments, labels and time entries.

This is Kaneo's own server for its open-source project board. It runs on your computer and signs in to your Kaneo instance in the browser the first time a tool is used. You can set an API key instead for headless use. It reaches Kaneo at localhost:1337 unless you point it at your own address. It can delete tasks, comments and labels, so check requests before you approve them.

Good for

  • Teams on Kaneo who want an assistant to file and update tasks
  • Developers who track work from the editor, with ticket keys like KAN-12
  • Self-hosters who want one server for their own Kaneo instance

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install kaneo MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the kaneo MCP server to Claude Code. Run this command:
    
    claude mcp add kaneo -- npx -y @kaneo/mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, A running Kaneo instance; Node.js 24 or newer.

Set KANEO_API_URL in the server env to your Kaneo address, without /api, since the default is http://localhost:1337. The first tool call opens a browser to approve sign-in, or set KANEO_API_KEY for headless use. The README also has an interactive installer, npx @kaneo/mcp, which writes the config for Cursor or Claude Desktop.

Built from the package data we hold. Not yet tested by us.

Tools

  • Searches tasks, projects, comments and activity

    Searches across tasks, projects, workspaces, comments and activity entries.

    Try: “Find everything about the checkout bug.”

    Network · search

  • Lists the tasks in a project

    Lists tasks in a project so the assistant can see what is open.

    Try: “What tasks are open in the Website project?”

    Network · list_tasks

  • Opens one task

    Returns one task by its ID with its details.

    Try: “Show me task abc123.”

    Network · get_task

  • Finds a task by its ticket key

    Fetches a task by a key such as KAN-12. If several tasks share a key, you can narrow it by workspace or project.

    Try: “Open KAN-12.”

    Network · get_task_by_ticket_id

  • Creates a task

    Creates a task in a project, using a status column that exists in that project.

    Try: “Create a task "Fix login redirect" in the Website project, high priority.”

    Write · create_task

  • Copies a task

    Duplicates a task in the same project with its fields and labels. You can give the copy a new title.

    Try: “Duplicate KAN-12 as "Fix login redirect on mobile".”

    Write · duplicate_task

  • Edits a task

    Changes the details of an existing task.

    Try: “Rename KAN-12 to "Fix login redirect loop".”

    Write · update_task

  • Moves a task to another status column

    Sets a task to a status column slug that the project has.

    Try: “Move KAN-12 to In Review.”

    Write · update_task_status

  • Assigns or unassigns a task

    Assigns a task to a workspace member, or clears the assignee.

    Try: “Assign KAN-12 to Sam.”

    Write · update_task_assignee

  • Sets or clears a due date

    Changes the due date of a task.

    Try: “Set KAN-12 due next Friday.”

    Write · update_task_due_date

  • Moves a task to another project

    Moves a task to another project and, if you want, to a column there.

    Try: “Move KAN-12 to the Mobile project.”

    Write · move_task

  • Deletes a task

    Deletes a task by ID.

    Try: “Delete task abc123.”

    Delete · delete_task

From the official docs

Permissions

high risk · 3 things to watch · 2 advisories

High risk

The assistant can read and change your Kaneo boards and delete tasks, comments and labels as you. Approve delete calls by hand and try it on a test workspace first.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete tasks, comments and labels

    Delete tools remove tasks, comments, labels and task links. Approve each delete call yourself and keep a backup of important boards. github.com

  • It edits everything you can edit

    Writes run as your Kaneo user, so tasks, assignees, due dates and projects can change. Check bulk requests before you approve them. github.com

  • Sign-in token is kept on disk

    The browser sign-in saves a token in your home folder. Use an API key in the environment instead if you do not want a file. github.com

Security advisories

Technical details
Turning on read-onlyNo read-only switch is documented.
Talks toYour Kaneo instance (KANEO_API_URL, default http://localhost:1337)
Sign-in and keysBrowser sign-in stores a token in ~/.config/kaneo-mcp/credentials.json with mode 0600. With KANEO_API_KEY set, no token is stored on disk.

Questions

Is the Kaneo MCP server official?

Yes. The README calls @kaneo/mcp the official Kaneo MCP server, maintained in the Kaneo repo and published by the Kaneo team.

What do I need before I install it?

Node.js 24 or newer and a running Kaneo API with its web app for the sign-in approval. The default address is http://localhost:1337, so set KANEO_API_URL for any other instance.

Can I connect without installing anything?

Yes if your client supports Streamable HTTP. Every Kaneo instance has a built-in endpoint at /api/mcp on your own Kaneo address, which uses OAuth sign-in and offers the same tools.

Does it need an API key?

No. By default it opens a browser sign-in. For headless setups you can create a key under Settings, Account, Developer and set KANEO_API_KEY.

Can it delete my tasks?

Yes. It can delete tasks, comments, labels and task relations. There is no read-only mode. It cannot delete time entries, because the API has no such endpoint.

Which AI apps does it work in?

The docs name Cursor and Claude Desktop for the installer, and Claude Code for the built-in HTTP endpoint. Use the install box above for each app.

Information

updated Nov 2, 2026

Publisher
Official
Package
@kaneo/mcp
Registry
npm
Transport
stdio
Auth
OAuth
Version
0.1.14
License
MIT
Last commit
Oct 30, 2026
Open issues
41
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.