npm package: @shubhangc/kanbanwala-mcp
Description: MCP Server for KanbanWala - A comprehensive Model Context Protocol server for managing boards, tasks, folders, projects, and more
Author: Shubhang Chakrawarty
Latest version: 1.0.7

# 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](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](https://kanban-wala.vercel.app/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.

```bash
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`

```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:
   ```bash
   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