mcp-kaneo

MCP server for Kaneo task management API. Lets your AI coding assistant manage tasks, projects, labels, and comments in Kaneo.

Features

• Tasks: Create, read, update, delete tasks

• Projects: List and manage projects

• Labels: Create, update, delete labels; attach/detach from tasks

• Comments: Add and list comments on tasks

• Search: Search tasks, projects, and workspaces

• Workspaces: List workspaces and organizations

• Task Relations: Create subtask relations (links to Kaneo's native subtasks)

Requirements

• Node.js v18 or later

• Kaneo account with API access

Installation

Using npx (recommended)

npx @fastman/mcp-kaneo

Using npm

npm install -g @fastman/mcp-kaneo
npx @fastman/mcp-kaneo

Configuration

Environment Variables

OpenCode

Add to your ~/.config/opencode/opencode.json:

{
  "mcp": {
    "kaneo": {
      "type": "local",
      "command": ["npx", "-y", "@fastman/mcp-kaneo"],
      "environment": {
        "KANEO_BASE_URL": "https://your-kaneo-instance.com/api",
        "KANEO_TOKEN": "${KANEO_TOKEN}"
      }
    }
  }
}

Or for local development:

{
  "mcp": {
    "kaneo": {
      "type": "local",
      "command": ["node", "/path/to/mcp-kaneo/dist/index.js"],
      "environment": {
        "KANEO_BASE_URL": "https://your-kaneo-instance.com/api",
        "KANEO_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add kaneo --scope user npx @fastman/mcp-kaneo

Cline

Add to your MCP settings:

{
  "mcpServers": {
    "kaneo": {
      "command": "npx",
      "args": ["-y", "@fastman/mcp-kaneo"]
    }
  }
}

Cursor

Go to Cursor Settings → MCP → New MCP Server:

{
  "command": "npx",
  "args": ["-y", "@fastman/mcp-kaneo"]
}

Tools

Workspaces

• kaneo_list_workspaces - List all accessible workspaces

Projects

• kaneo_list_projects - List projects in a workspace

• kaneo_get_project - Get project details

• kaneo_create_project - Create a new project

Tasks

• kaneo_create_task - Create a new task

• kaneo_get_task - Get task details

• kaneo_update_task_title - Update task title

• kaneo_update_task_description - Update task description

• kaneo_update_task_status - Update task status (move between columns)

• kaneo_update_task_priority - Update task priority

• kaneo_update_task_assignee - Update task assignee

• kaneo_update_task_due_date - Update task due date

• kaneo_delete_task - Delete a task

• kaneo_list_tasks - List tasks in a project

• kaneo_create_subtask - Create a subtask linked to a parent (native Kaneo subtask)

• kaneo_list_subtasks - List subtasks for a parent task (via Task Relations)

Labels

• kaneo_list_labels - List workspace labels

• kaneo_create_label - Create a new label

• kaneo_update_label - Update label name/color

• kaneo_delete_label - Delete a label

• kaneo_attach_label - Attach label to task

• kaneo_detach_label - Detach label from task

• kaneo_list_task_labels - List labels on a task

Comments

• kaneo_add_comment - Add comment to task

• kaneo_list_comments - List comments on task

Search

• kaneo_search - Search tasks, projects, workspaces

Task Relations

• kaneo_create_task_relation - Create a relation between tasks (subtask, blocks, related)

• kaneo_list_task_relations - List all relations for a task

• kaneo_delete_task_relation - Delete a task relation

Usage Examples

Create a task

Create a task in kaneo called "Fix login bug" with high priority

Create a subtask

Create a subtask "Fix the login validation" for parent task #123

List subtasks

List all subtasks for task #123

Add a label

Create a label called "bug" with color #ef4444 and attach it to the task

Update task status

Move the task "Fix login bug" to in-progress

Development

# Install dependencies
npm install

# Build
npm run build

# Test
npm test

# Run locally
npm start

License

MIT