KanbanWala MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with KanbanWala. Provides 38+ tools for managing boards, tasks, folders, projects, features, planner tasks, analytics, and settings.

🔗 App URL: https://kanban-wala.vercel.app

🚀 Getting Started

1. Get your API Key

You need an API key from your KanbanWala account to use this server.

1. Go to KanbanWala Settings
2. Scroll to the "API & Integrations" section
3. Click "Generate New API Key"
4. Give it a name (e.g., "Claude Desktop")
5. Copy the key immediately (it won't be shown again)

2. Run with npx (Quick Start)

You can run the server directly using npx. This is useful for testing or one-off usage.

npx -y @shubhangc/kanbanwala-mcp@latest

🤖 AI Agent Setup

Claude Desktop Configuration

To use KanbanWala with Claude, add the following to your claude_desktop_config.json file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kanbanwala": {
      "command": "npx",
      "args": ["-y", "@shubhangc/kanbanwala-mcp@latest"],
      "env": {
        "KANBANWALA_API_KEY": "YOUR_API_KEY_HERE",
        "KANBANWALA_API_URL": "https://kanban-wala.vercel.app"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with the key you generated in step 1.

Perplexity Configuration

Perplexity also supports MCP servers via npx.

1. Open Perplexity Settings
2. Navigate to the MCP section
3. In the "Install from NPM" (or similar) field, enter:

   npx -y @shubhangc/kanbanwala-mcp@latest

🛠️ Available Tools

This server exposes a wide range of tools to manage your KanbanWala workspace.

📋 Tasks & User Stories

• list_tasks: List tasks, optionally filtered by board.
• get_task: Get details of a specific task.
• create_task: Create a standard task.
• create_user_story: Create a detailed user story with agile fields (priority, story points, acceptance criteria).
• update_task: Update task details, status, or content.
• delete_task: Delete a task.
• move_task: Move a task to a different board or column.
• bulk_create_tasks: Create multiple tasks at once.
• search_tasks: Search tasks by title, description, or status.

📊 Boards

• list_boards: List all boards with task counts.
• get_board: Get full board details including columns and tasks.
• create_board: Create a new Kanban board.
• update_board: Update board metadata (name, description, icon).
• delete_board: Delete a board.
• move_board_to_folder: Organize boards into folders.
• find_board_by_name: Fuzzy search for boards.

📁 Folders

• list_folders: List all folders.
• create_folder: Create a new folder.
• update_folder: Update folder details.
• delete_folder: Delete a folder.
• find_folder_by_name: Search for folders.

🚀 Projects & Features

• list_projects: List all projects.
• create_project: Create a new project.
• update_project: Update project details.
• delete_project: Delete a project.
• list_features: List features within a project.
• create_feature: Create a feature (automatically creates a linked board).
• update_feature: Update feature status/priority.
• delete_feature: Delete a feature.

📅 Planner (Daily/Weekly)

• list_planner_tasks: List tasks in your day planner.
• create_planner_task: Add a task to your planner.
• update_planner_task: Update planner entries.
• delete_planner_task: Remove a planner task.
• add_subtask: Add subtasks to a planner item.
• toggle_planner_task_complete: Mark planner items as done.

📈 Analytics

• get_flow_analytics: Get flow state session data.
• get_energy_analytics: View your energy level patterns.
• get_sprint_analytics: Review sprint performance metrics.

⚙️ Settings

• get_settings: Retrieve current user preferences.
• update_settings: Update theme, fonts, and other settings.

License

MIT