set_paragraph_spacing

Adjust spacing between paragraphs in Figma text nodes to improve readability and visual hierarchy in designs.

Instructions

Set the paragraph 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
`paragraphSpacing`	Yes	Paragraph spacing value in pixels

Implementation Reference

src/talk_to_figma_mcp/tools/text-tools.ts:341-375 (registration)

Registers the MCP tool 'set_paragraph_spacing' including its description, Zod input schema (nodeId: string, paragraphSpacing: number), and async handler. The handler sends the command to the Figma plugin via sendCommandToFigma and returns a formatted success or error message.

// Set Paragraph Spacing Tool
server.tool(
  "set_paragraph_spacing",
  "Set the paragraph spacing of a text node in Figma",
  {
    nodeId: z.string().describe("The ID of the text node to modify"),
    paragraphSpacing: z.number().describe("Paragraph spacing value in pixels"),
  },
  async ({ nodeId, paragraphSpacing }) => {
    try {
      const result = await sendCommandToFigma("set_paragraph_spacing", {
        nodeId,
        paragraphSpacing
      });
      const typedResult = result as { name: string, paragraphSpacing: number };
      return {
        content: [
          {
            type: "text",
            text: `Updated paragraph spacing of node "${typedResult.name}" to ${typedResult.paragraphSpacing}px`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error setting paragraph spacing: ${error instanceof Error ? error.message : String(error)}`
          }
        ]
      };
    }
  }
);

src/talk_to_figma_mcp/tools/text-tools.ts:349-374 (handler)

The core handler logic for executing the 'set_paragraph_spacing' tool: calls sendCommandToFigma with parameters, type-casts the result, and returns content with update confirmation or error.

async ({ nodeId, paragraphSpacing }) => {
  try {
    const result = await sendCommandToFigma("set_paragraph_spacing", {
      nodeId,
      paragraphSpacing
    });
    const typedResult = result as { name: string, paragraphSpacing: number };
    return {
      content: [
        {
          type: "text",
          text: `Updated paragraph spacing of node "${typedResult.name}" to ${typedResult.paragraphSpacing}px`
        }
      ]
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text",
          text: `Error setting paragraph spacing: ${error instanceof Error ? error.message : String(error)}`
        }
      ]
    };
  }
}

src/talk_to_figma_mcp/tools/text-tools.ts:345-348 (schema)

Zod schema defining inputs for the tool: nodeId (string) and paragraphSpacing (number).

{
  nodeId: z.string().describe("The ID of the text node to modify"),
  paragraphSpacing: z.number().describe("Paragraph spacing value in pixels"),
},

src/talk_to_figma_mcp/types/index.ts:76-76 (helper)
Includes 'set_paragraph_spacing' in the FigmaCommand type union, used internally for typing the commands sent to Figma plugin.
```
| "set_paragraph_spacing"
```

Claude Talk to Figma MCP