Claude Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/modification-tools.ts:341-368 (handler)

  The asynchronous handler function for the 'set_effects' MCP tool. It sends the nodeId and effects array to Figma using sendCommandToFigma and returns a success message with the node name or an error message.

  async ({ nodeId, effects }) => {
    try {
      const result = await sendCommandToFigma("set_effects", {
        nodeId,
        effects
      });
      
      const typedResult = result as { name: string, effects: any[] };
      
      return {
        content: [
          {
            type: "text",
            text: `Successfully applied ${effects.length} effect(s) to node "${typedResult.name}"`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error setting effects: ${error instanceof Error ? error.message : String(error)}`
          }
        ]
      };
    }
  }

• src/talk_to_figma_mcp/tools/modification-tools.ts:319-340 (schema)

  Zod schema defining the input parameters for the set_effects tool: nodeId (string) and effects (array of effect objects with type, optional color, offset, radius, spread, visible, blendMode).

  {
    nodeId: z.string().describe("The ID of the node to modify"),
    effects: z.array(
      z.object({
        type: z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]).describe("Effect type"),
        color: z.object({
          r: z.number().min(0).max(1).describe("Red (0-1)"),
          g: z.number().min(0).max(1).describe("Green (0-1)"),
          b: z.number().min(0).max(1).describe("Blue (0-1)"),
          a: z.number().min(0).max(1).describe("Alpha (0-1)")
        }).optional().describe("Effect color (for shadows)"),
        offset: z.object({
          x: z.number().describe("X offset"),
          y: z.number().describe("Y offset")
        }).optional().describe("Offset (for shadows)"),
        radius: z.number().optional().describe("Effect radius"),
        spread: z.number().optional().describe("Shadow spread (for shadows)"),
        visible: z.boolean().optional().describe("Whether the effect is visible"),
        blendMode: z.string().optional().describe("Blend mode")
      })
    ).describe("Array of effects to apply")
  },

• src/talk_to_figma_mcp/tools/modification-tools.ts:316-369 (registration)

  MCP server.tool registration call for 'set_effects', including description, input schema, and handler function.

  server.tool(
    "set_effects",
    "Set the visual effects of a node in Figma",
    {
      nodeId: z.string().describe("The ID of the node to modify"),
      effects: z.array(
        z.object({
          type: z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]).describe("Effect type"),
          color: z.object({
            r: z.number().min(0).max(1).describe("Red (0-1)"),
            g: z.number().min(0).max(1).describe("Green (0-1)"),
            b: z.number().min(0).max(1).describe("Blue (0-1)"),
            a: z.number().min(0).max(1).describe("Alpha (0-1)")
          }).optional().describe("Effect color (for shadows)"),
          offset: z.object({
            x: z.number().describe("X offset"),
            y: z.number().describe("Y offset")
          }).optional().describe("Offset (for shadows)"),
          radius: z.number().optional().describe("Effect radius"),
          spread: z.number().optional().describe("Shadow spread (for shadows)"),
          visible: z.boolean().optional().describe("Whether the effect is visible"),
          blendMode: z.string().optional().describe("Blend mode")
        })
      ).describe("Array of effects to apply")
    },
    async ({ nodeId, effects }) => {
      try {
        const result = await sendCommandToFigma("set_effects", {
          nodeId,
          effects
        });
        
        const typedResult = result as { name: string, effects: any[] };
        
        return {
          content: [
            {
              type: "text",
              text: `Successfully applied ${effects.length} effect(s) to node "${typedResult.name}"`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error setting effects: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

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

  Invocation of registerModificationTools function, which registers the set_effects tool among others, within the main registerTools aggregator.

  registerModificationTools(server);

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

  Inclusion of 'set_effects' in the FigmaCommand type union, used for typing commands sent to Figma.

  | "set_effects"