Claude Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/creation-tools.ts:584-619 (handler)

  Full MCP tool registration including schema, description, and handler function for 'flatten_node'. The handler sends a 'flatten_node' command to the Figma plugin via websocket and formats the response.

  server.tool(
    "flatten_node",
    "Flatten a node in Figma (e.g., for boolean operations or converting to path)",
    {
      nodeId: z.string().describe("ID of the node to flatten"),
    },
    async ({ nodeId }) => {
      try {
        const result = await sendCommandToFigma("flatten_node", { nodeId });
        
        const typedResult = result as { 
          id: string, 
          name: string, 
          type: string 
        };
        
        return {
          content: [
            {
              type: "text",
              text: `Node "${typedResult.name}" flattened successfully. The new node has ID: ${typedResult.id} and is of type ${typedResult.type}.`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error flattening node: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

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

  Calls registerCreationTools which registers the flatten_node tool among others.

  registerCreationTools(server);

• src/talk_to_figma_mcp/types/index.ts:86-86 (helper)

  Includes 'flatten_node' in the FigmaCommand type union for type safety in websocket communications.

  | "flatten_node"