Focalboard MCP Server

Instructions

Implementation Reference

• src/index.ts:376-390 (handler)

  The main execution handler for the 'get_card' MCP tool. It validates the cardId input, calls FocalboardClient.getCard(), and formats the response as MCP content.

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

• src/index.ts:132-145 (registration)

  Tool registration definition for 'get_card' including name, description, and input schema used by MCP server for listing and validation.

  {
    name: 'get_card',
    description: 'Get detailed information about a specific card by its ID.',
    inputSchema: {
      type: 'object',
      properties: {
        cardId: {
          type: 'string',
          description: 'The ID of the card to retrieve'
        }
      },
      required: ['cardId']
    }
  },

• src/focalboard-client.ts:214-216 (helper)

  Core helper method in FocalboardClient that performs the HTTP API request to fetch the specific card by ID.

  async getCard(cardId: string): Promise<Card> {
    return this.makeRequest<Card>(`/cards/${cardId}`);
  }