Focalboard MCP Server

Instructions

Implementation Reference

• src/index.ts:219-232 (registration)

  Registration of the 'get_card_content' MCP tool, including name, description, and input schema requiring 'cardId'.

  {
    name: 'get_card_content',
    description: 'Get all content blocks (descriptions) for a card.',
    inputSchema: {
      type: 'object',
      properties: {
        cardId: {
          type: 'string',
          description: 'The ID of the card to get content for'
        }
      },
      required: ['cardId']
    }
  }

• src/index.ts:478-494 (handler)

  MCP tool handler for 'get_card_content': validates cardId, calls focalboard.getCardContent(), formats result as JSON text response.

  case 'get_card_content': {
    const cardId = args?.cardId as string;
  
    if (!cardId) {
      throw new Error('cardId is required');
    }
  
    const contentBlocks = await focalboard.getCardContent(cardId);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(contentBlocks, null, 2)
        }
      ]
    };
  }

• src/focalboard-client.ts:401-413 (helper)

  Core implementation in FocalboardClient.getCardContent(): fetches card to get boardId, then retrieves child content blocks via API using parent_id filter.

  async getCardContent(cardId: string): Promise<Block[]> {
    const card = await this.getCard(cardId);
  
    // Fetch blocks with parent_id parameter
    const blocks = await this.makeRequest<Block[]>(
      `/boards/${card.boardId}/blocks`,
      'GET',
      undefined,
      { parent_id: cardId }
    );
  
    return blocks;
  }