set_letter_spacing
Adjust text spacing in Figma by setting letter spacing values in pixels or percentages for precise typography control.
Instructions
Set the letter spacing of a text node in Figma
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | Yes | The ID of the text node to modify | |
| letterSpacing | Yes | Letter spacing value | |
| unit | No | Unit type (PIXELS or PERCENT) |
Implementation Reference
- src/talk_to_figma_mcp/tools/text-tools.ts:266-301 (registration)Registers the MCP tool 'set_letter_spacing' using server.tool(), including description, Zod input schema (nodeId, letterSpacing, optional unit), and the handler function that proxies the command to Figma via sendCommandToFigma.server.tool( "set_letter_spacing", "Set the letter spacing of a text node in Figma", { nodeId: z.string().describe("The ID of the text node to modify"), letterSpacing: z.number().describe("Letter spacing value"), unit: z.enum(["PIXELS", "PERCENT"]).optional().describe("Unit type (PIXELS or PERCENT)"), }, async ({ nodeId, letterSpacing, unit }) => { try { const result = await sendCommandToFigma("set_letter_spacing", { nodeId, letterSpacing, unit: unit || "PIXELS" }); const typedResult = result as { name: string, letterSpacing: { value: number, unit: string } }; return { content: [ { type: "text", text: `Updated letter spacing of node "${typedResult.name}" to ${typedResult.letterSpacing.value} ${typedResult.letterSpacing.unit}` } ] }; } catch (error) { return { content: [ { type: "text", text: `Error setting letter spacing: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
- The handler logic for the set_letter_spacing tool: sends the parameters to Figma using sendCommandToFigma, handles the response, and formats a user-friendly text response.async ({ nodeId, letterSpacing, unit }) => { try { const result = await sendCommandToFigma("set_letter_spacing", { nodeId, letterSpacing, unit: unit || "PIXELS" }); const typedResult = result as { name: string, letterSpacing: { value: number, unit: string } }; return { content: [ { type: "text", text: `Updated letter spacing of node "${typedResult.name}" to ${typedResult.letterSpacing.value} ${typedResult.letterSpacing.unit}` } ] }; } catch (error) { return { content: [ { type: "text", text: `Error setting letter spacing: ${error instanceof Error ? error.message : String(error)}` } ] }; } }
- Input schema using Zod for validating tool parameters: nodeId (string), letterSpacing (number), unit (optional enum PIXELS/PERCENT).{ nodeId: z.string().describe("The ID of the text node to modify"), letterSpacing: z.number().describe("Letter spacing value"), unit: z.enum(["PIXELS", "PERCENT"]).optional().describe("Unit type (PIXELS or PERCENT)"), },
- TypeScript type definition for FigmaCommand union, which includes "set_letter_spacing" as a valid command name sent to the Figma plugin.export type FigmaCommand = | "get_document_info" | "get_selection" | "get_node_info" | "create_rectangle" | "create_frame" | "create_text" | "create_ellipse" | "create_polygon" | "create_star" | "create_vector" | "create_line" | "set_fill_color" | "set_stroke_color" | "move_node" | "resize_node" | "delete_node" | "get_styles" | "get_local_components" | "get_team_components" | "create_component_instance" | "export_node_as_image" | "join" | "set_corner_radius" | "clone_node" | "set_text_content" | "scan_text_nodes" | "set_multiple_text_contents" | "set_auto_layout" | "set_font_name" | "set_font_size" | "set_font_weight" | "set_letter_spacing" | "set_line_height" | "set_paragraph_spacing" | "set_text_case" | "set_text_decoration" | "get_styled_text_segments" | "load_font_async" | "get_remote_components" | "set_effects" | "set_effect_style_id" | "group_nodes" | "ungroup_nodes" | "flatten_node" | "insert_child";