
Kaneo MCP Server: Setup for Claude Code, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install kaneo MCP
Claude Code
- 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
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 ·
searchLists 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_tasksOpens one task
Returns one task by its ID with its details.
Try: “Show me task abc123.”
Network ·
get_taskFinds 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_idCreates 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_taskCopies 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_taskEdits a task
Changes the details of an existing task.
Try: “Rename KAN-12 to "Fix login redirect loop".”
Write ·
update_taskMoves 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_statusAssigns or unassigns a task
Assigns a task to a workspace member, or clears the assignee.
Try: “Assign KAN-12 to Sam.”
Write ·
update_task_assigneeSets or clears a due date
Changes the due date of a task.
Try: “Set KAN-12 due next Friday.”
Write ·
update_task_due_dateMoves 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_taskDeletes a task
Deletes a task by ID.
Try: “Delete task abc123.”
Delete ·
delete_taskShows what changed on a task
Lists the activity history of a task.
Try: “What happened on KAN-12 this week?”
Network ·
list_task_activityLists your projects
Lists the projects in a workspace.
Try: “List my Kaneo projects.”
Network ·
list_projectsOpens one project
Returns details about a project.
Try: “Show the Website project.”
Network ·
get_projectCreates a project
Creates a new project in a workspace.
Try: “Create a project called Q1 Launch.”
Write ·
create_projectEdits a project
Changes the details of a project.
Try: “Rename the Website project to Marketing Site.”
Write ·
update_projectLists a project's status columns
Returns the status columns of a project. Call it first, because create and status tools only accept these column slugs.
Try: “What statuses does the Website project use?”
Network ·
list_project_columnsLists a project's custom fields
Returns the custom fields and their options for a project.
Try: “What custom fields does the Website project have?”
Network ·
list_project_custom_fieldsReads a task's custom fields
Returns the custom field values set on a task.
Try: “What are the custom fields on KAN-12?”
Network ·
get_task_custom_field_valuesSets or clears a custom field
Sets or clears one custom field value on a task. Required fields cannot be cleared.
Try: “Set the Customer field on KAN-12 to Acme.”
Write ·
set_task_custom_field_valueLists your workspaces
Lists the workspaces you can use.
Try: “Which Kaneo workspaces do I have?”
Network ·
list_workspacesLists the people in a workspace
Lists workspace members. The assignee tools need these user IDs.
Try: “Who is in my workspace?”
Network ·
list_workspace_membersShows your notifications
Lists the signed-in user's notifications.
Try: “What are my unread Kaneo notifications?”
Network ·
list_notificationsLists comments on a task
Returns the comments on a task.
Try: “Show comments on KAN-12.”
Network ·
list_task_commentsAdds a comment
Adds a comment to a task.
Try: “Comment on KAN-12 that the fix is deployed.”
Write ·
create_task_commentEdits a comment
Changes the text of an existing comment.
Try: “Fix the typo in my last comment on KAN-12.”
Write ·
update_task_commentDeletes a comment
Deletes a comment from a task.
Try: “Delete my last comment on KAN-12.”
Delete ·
delete_task_commentLists labels
Lists the labels in a workspace.
Try: “What labels do we use?”
Network ·
list_workspace_labelsCreates a label
Creates a new label.
Try: “Create a label called regression.”
Write ·
create_labelAdds a label to a task
Attaches a label to a task.
Try: “Tag KAN-12 with regression.”
Write ·
attach_label_to_taskRemoves a label from a task
Takes a label off a task without deleting the label.
Try: “Remove the regression label from KAN-12.”
Write ·
detach_label_from_taskDeletes a label
Deletes a task label or a workspace label by ID. For a workspace label the tool repeats the delete until it finishes, and you can call it again if the result says deletion is still pending.
Try: “Delete the label "old".”
Delete ·
delete_labelLinks two tasks
Links tasks as subtask, blocks or related.
Try: “Make KAN-13 a subtask of KAN-12.”
Write ·
create_task_relationShows linked tasks
Lists the relations a task has.
Try: “What blocks KAN-12?”
Network ·
get_task_relationsRemoves a link between tasks
Deletes a relation between two tasks.
Try: “Remove the blocks link between KAN-12 and KAN-14.”
Delete ·
delete_task_relationLists time logged on a task
Returns the time entries logged against a task.
Try: “How much time is logged on KAN-12?”
Network ·
list_task_time_entriesOpens one time entry
Returns one time entry by ID.
Try: “Show time entry abc123.”
Network ·
get_time_entryLogs time on a task
Logs time against a task. Leave the end time out to leave the entry running.
Try: “Log 2 hours on KAN-12 starting at 9am.”
Write ·
create_time_entryEdits a time entry
Changes an existing time entry. There is no tool to delete time entries.
Try: “Change that entry to end at 11am.”
Write ·
update_time_entryUsed by the assistant behind the scenes
Shows who you are signed in as
Returns the current Kaneo user for the sign-in method in use.
Try: “Who am I signed in as in Kaneo?”
Network ·
whoami
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
2 known advisories, all fixed in a newer version.
- Older Kaneo HTTP MCP routes lacked request-body and batch limitsmedium · Fixed in 2.29.0 · GHSA-4gvv-75jf-j2c4
- MCP authorization codes could be redeemed after their approving session was revokedmedium · Fixed in 2.47.1 · GHSA-65r2-xcww-hg5m
16 other advisories are about the wider kaneo project, not this MCP server. See them on GitHub
Technical details
| Turning on read-only | No read-only switch is documented. |
|---|---|
| Talks to | Your Kaneo instance (KANEO_API_URL, default http://localhost:1337) |
| Sign-in and keys | Browser 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com