# kaneo

The official Kaneo MCP server lets your agent read and change tasks, projects and labels from the chat. Useful when your work lives in Kaneo and you'd rather not switch windows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 9602
- Author: usekaneo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/usekaneo/kaneo
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/kaneo

## What it does

The server wires an AI client to your Kaneo instance over its API. From the chat you can list projects, create tasks, apply labels and dig through whatever is sitting in the backlog. It runs through `npx -y @kaneo/mcp`, so there is nothing to build first.

Two variables are required: `KANEO_API_URL` and `KANEO_API_KEY`. Without the key the server cannot authenticate, so create one in Kaneo before you start. Claude offers a short form that takes only the key, and a longer one that names the URL and the stdio transport explicitly.

Kaneo itself is open source under MIT, and you can run it in the cloud or on your own box. The MCP server is a thin layer over the API, so the agent gets exactly the access your key grants. Issue a key for the job at hand rather than reusing an admin one.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KANEO_API_URL`, `KANEO_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KANEO_API_URL=<KANEO_API_URL> --env KANEO_API_KEY=<KANEO_API_KEY> --transport stdio kaneo -- npx -y @kaneo/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add kaneo --env KANEO_API_URL=<KANEO_API_URL> --env KANEO_API_KEY=<KANEO_API_KEY> -- npx -y @kaneo/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kaneo": {
            "command": "npx",
            "args": [
                "-y",
                "@kaneo/mcp"
            ],
            "env": {
                "KANEO_API_URL": "<KANEO_API_URL>",
                "KANEO_API_KEY": "<KANEO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kaneo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@kaneo/mcp"
            ],
            "env": {
                "KANEO_API_URL": "<KANEO_API_URL>",
                "KANEO_API_KEY": "<KANEO_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KANEO_API_URL=<KANEO_API_URL> -e KANEO_API_KEY=<KANEO_API_KEY> kaneo npx -y @kaneo/mcp
```
Replace <…> with your own values

## When to use it
- file a task in Kaneo without opening a browser
- check what is left in a project backlog
- tag several tasks at once
- find a project by name and pull its tasks
- turn a chat decision into a task description

## Example prompts
- List every open task in the Kaneo project
- Create a Kaneo task: fix auth in the API, label backend
- Find Kaneo tasks labelled bug and group them by project

## Similar
- [todo](https://affpapa.org/en/nevibecode/commands/todo.md) — command · 2723 installs
- [start](https://affpapa.org/en/nevibecode/commands/start.md) — command · 945 installs
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md