Claude Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/modification-tools.ts:73-108 (handler)

  Handler function for 'set_stroke_color' tool. Validates RGB inputs, applies defaults to color (alpha=1) and strokeWeight (=1), sends the command to Figma via sendCommandToFigma, parses result, and returns a text response with success or error message.

  async ({ nodeId, r, g, b, a, strokeWeight }) => {
    try {
  
      if (r === undefined || g === undefined || b === undefined) {
        throw new Error("RGB components (r, g, b) are required and cannot be undefined");
      }
      
      const colorInput: Color = { r, g, b, a };
      const colorWithDefaults = applyColorDefaults(colorInput);
      
      const strokeWeightWithDefault = applyDefault(strokeWeight, FIGMA_DEFAULTS.stroke.weight);
      
      const result = await sendCommandToFigma("set_stroke_color", {
        nodeId,
        color: colorWithDefaults,
        strokeWeight: strokeWeightWithDefault,
      });
      const typedResult = result as { name: string };
      return {
        content: [
          {
            type: "text",
            text: `Set stroke color of node "${typedResult.name}" to RGBA(${r}, ${g}, ${b}, ${colorWithDefaults.a}) with weight ${strokeWeightWithDefault}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }

• src/talk_to_figma_mcp/tools/modification-tools.ts:65-72 (schema)

  Zod input schema defining parameters for the set_stroke_color tool: nodeId (string), r/g/b (0-1 numbers), optional a (alpha), optional strokeWeight (>=0).

  {
    nodeId: z.string().describe("The ID of the node to modify"),
    r: z.number().min(0).max(1).describe("Red component (0-1)"),
    g: z.number().min(0).max(1).describe("Green component (0-1)"),
    b: z.number().min(0).max(1).describe("Blue component (0-1)"),
    a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"),
    strokeWeight: z.number().min(0).optional().describe("Stroke weight >= 0)"),
  },

• src/talk_to_figma_mcp/tools/modification-tools.ts:62-110 (registration)

  server.tool() registration call for 'set_stroke_color' including name, description, input schema, and handler function. This is called from registerModificationTools(server).

  server.tool(
    "set_stroke_color",
    "Set the stroke color of a node in Figma (defaults: opacity 1, weight 1)",
    {
      nodeId: z.string().describe("The ID of the node to modify"),
      r: z.number().min(0).max(1).describe("Red component (0-1)"),
      g: z.number().min(0).max(1).describe("Green component (0-1)"),
      b: z.number().min(0).max(1).describe("Blue component (0-1)"),
      a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"),
      strokeWeight: z.number().min(0).optional().describe("Stroke weight >= 0)"),
    },
    async ({ nodeId, r, g, b, a, strokeWeight }) => {
      try {
  
        if (r === undefined || g === undefined || b === undefined) {
          throw new Error("RGB components (r, g, b) are required and cannot be undefined");
        }
        
        const colorInput: Color = { r, g, b, a };
        const colorWithDefaults = applyColorDefaults(colorInput);
        
        const strokeWeightWithDefault = applyDefault(strokeWeight, FIGMA_DEFAULTS.stroke.weight);
        
        const result = await sendCommandToFigma("set_stroke_color", {
          nodeId,
          color: colorWithDefaults,
          strokeWeight: strokeWeightWithDefault,
        });
        const typedResult = result as { name: string };
        return {
          content: [
            {
              type: "text",
              text: `Set stroke color of node "${typedResult.name}" to RGBA(${r}, ${g}, ${b}, ${colorWithDefaults.a}) with weight ${strokeWeightWithDefault}`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
        };
      }
    }
  );

• src/talk_to_figma_mcp/types/index.ts:55-55 (schema)

  Included in FigmaCommand type union for TypeScript typing of commands sent to Figma websocket.

  | "set_stroke_color"

• src/talk_to_figma_mcp/tools/index.ts:16-16 (registration)

  Higher-level registration call to registerModificationTools which includes set_stroke_color, invoked from registerTools(server).

  registerModificationTools(server);