Cursor Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/server.ts:2302-2336 (handler)

  MCP server.tool registration, input schema (Zod), and handler function for the 'set_item_spacing' tool. The handler proxies the parameters to a Figma plugin command via sendCommandToFigma and formats the response.

  server.tool(
    "set_item_spacing",
    "Set distance between children in an auto-layout frame",
    {
      nodeId: z.string().describe("The ID of the frame to modify"),
      itemSpacing: z.number().describe("Distance between children. Note: This value will be ignored if primaryAxisAlignItems is set to SPACE_BETWEEN.")
    },
    async ({ nodeId, itemSpacing }) => {
      try {
        const result = await sendCommandToFigma("set_item_spacing", {
          nodeId,
          itemSpacing
        });
        const typedResult = result as { name: string };
  
        return {
          content: [
            {
              type: "text",
              text: `Set item spacing to ${itemSpacing} for frame "${typedResult.name}"`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error setting item spacing: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
        };
      }
    }
  );

• src/talk_to_figma_mcp/server.ts:2582-2582 (schema)

  The 'set_item_spacing' command is included in the FigmaCommand type union, confirming it's a recognized Figma plugin command proxied by this MCP tool.

  | "set_item_spacing"