home / mcp / taskboard mcp server

Taskboard MCP Server

Provides an MCP interface for Taskboard to access workspaces, boards, lists, and cards via Copilot Chat.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aditya020402-mcp": {
      "url": "http://localhost:3001",
      "headers": {
        "MCP_SERVER_PORT": "3001",
        "TASKBOARD_API_URL": "http://localhost:3000/api",
        "TASKBOARD_AUTH_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

You can connect GitHub Copilot Chat to your Taskboard instance through a dedicated MCP server, enabling you to manage workspaces, boards, lists, and cards directly from Copilot. This server acts as an intermediary, translating Copilot queries into Taskboard API actions and returning results for your workflows.

How to use

To use the MCP server, run it locally or in your environment and point your MCP client to the provided HTTP endpoint. You will then be able to list workspaces, view boards, inspect lists, manage cards, and perform searches or updates through Copilot commands. The server also exposes endpoints for health checks and internal tool calls to support your workflow.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Ensure you have access to the Taskboard instance you want to connect to.

Step 1: Install dependencies for the MCP server.

cd mcp-server
npm install

Step 2: Configure environment variables for the MCP server. Create a .env file inside the mcp-server directory with the following content.

# Taskboard API Configuration
TASKBOARD_API_URL=http://localhost:3000/api
TASKBOARD_AUTH_TOKEN=your_auth_token_here
MCP_SERVER_PORT=3001

Run the server

Step 3: Start the MCP server in development or production mode.

npm run dev

To run in production mode, start the server with the production command.

npm start

Available tools

list_workspaces

List all accessible workspaces in the connected Taskboard instance.

list_boards

List boards within a specific workspace.

list_lists

List lists (columns) in a selected board.

list_cards

List cards within a chosen list.

search_cards

Search cards by title or description text.

view_card

Retrieve detailed information for a single card.

update_card_description

Update the description of a specific card.

update_card_status

Change the status of a card (e.g., from To Do to In Progress).

create_card

Create a new card within a specified list.

delete_card

Delete a card from a list.

get_activity

Get a summary of user activity for auditing or progress tracking.

query_rag

Query the knowledge base using a retrieval-augmented generation (RAG) setup.