export_node_as_image

Export Figma design elements as PNG, JPG, SVG, or PDF images by specifying node ID and scale for design documentation and asset creation.

Instructions

Export a node as an image from Figma

Input Schema

TableJSON Schema

Name	Required	Description
`nodeId`	Yes	The ID of the node to export
`format`	No	Export format
`scale`	No	Export scale

Implementation Reference

src/talk_to_figma_mcp/tools/document-tools.ts:360-388 (handler)

The main handler function for the 'export_node_as_image' MCP tool. It forwards the parameters to the Figma plugin via sendCommandToFigma and returns the resulting image data in MCP format.

async ({ nodeId, format, scale }) => {
  try {
    const result = await sendCommandToFigma("export_node_as_image", {
      nodeId,
      format: format || "PNG",
      scale: scale || 1,
    });
    const typedResult = result as { imageData: string; mimeType: string };

    return {
      content: [
        {
          type: "image",
          data: typedResult.imageData,
          mimeType: typedResult.mimeType || "image/png",
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text",
          text: `Error exporting node as image: ${error instanceof Error ? error.message : String(error)}`,
        },
      ],
    };
  }
}

src/talk_to_figma_mcp/tools/document-tools.ts:352-359 (schema)

Zod schema for input validation of the 'export_node_as_image' tool parameters.

{
  nodeId: z.string().describe("The ID of the node to export"),
  format: z
    .enum(["PNG", "JPG", "SVG", "PDF"])
    .optional()
    .describe("Export format"),
  scale: z.number().positive().optional().describe("Export scale"),
},

src/talk_to_figma_mcp/tools/document-tools.ts:349-389 (registration)

Registration of the 'export_node_as_image' tool with the MCP server using server.tool(), specifying name, description, input schema, and handler.

server.tool(
  "export_node_as_image",
  "Export a node as an image from Figma",
  {
    nodeId: z.string().describe("The ID of the node to export"),
    format: z
      .enum(["PNG", "JPG", "SVG", "PDF"])
      .optional()
      .describe("Export format"),
    scale: z.number().positive().optional().describe("Export scale"),
  },
  async ({ nodeId, format, scale }) => {
    try {
      const result = await sendCommandToFigma("export_node_as_image", {
        nodeId,
        format: format || "PNG",
        scale: scale || 1,
      });
      const typedResult = result as { imageData: string; mimeType: string };

      return {
        content: [
          {
            type: "image",
            data: typedResult.imageData,
            mimeType: typedResult.mimeType || "image/png",
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error exporting node as image: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }
);

src/talk_to_figma_mcp/types/index.ts:63-63 (helper)
The 'export_node_as_image' command is included in the FigmaCommand type union used for TypeScript typing of Figma plugin commands.
```
| "export_node_as_image"
```

Claude Talk to Figma MCP