Focalboard MCP Server

Instructions

Implementation Reference

• src/focalboard-client.ts:270-275 (handler)

  Core implementation of deleteCard method that sends DELETE request to the Focalboard API to remove the specified card block.

  async deleteCard(boardId: string, cardId: string): Promise<void> {
    await this.makeRequest<void>(
      `/boards/${boardId}/blocks/${cardId}`,
      'DELETE'
    );
  }

• src/index.ts:437-453 (handler)

  MCP tool execution handler for 'delete_card' that validates inputs and delegates to FocalboardClient.deleteCard.

  case 'delete_card': {
    const cardId = args?.cardId as string;
    const boardId = args?.boardId as string;
  
    if (!cardId || !boardId) {
      throw new Error('cardId and boardId are required');
    }
  
    await focalboard.deleteCard(boardId, cardId);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({ success: true, message: 'Card deleted successfully' })
        }
      ]
    };

• src/index.ts:180-195 (registration)

  Registration of the 'delete_card' tool including its name, description, and input schema.

  name: 'delete_card',
  description: 'Delete a card (task) from a board permanently.',
  inputSchema: {
    type: 'object',
    properties: {
      cardId: {
        type: 'string',
        description: 'The ID of the card to delete'
      },
      boardId: {
        type: 'string',
        description: 'The ID of the board the card belongs to'
      }
    },
    required: ['cardId', 'boardId']
  }