Talk to Figma MCP

Instructions

Implementation Reference

• src/cursor_mcp_plugin/code.js:490-519 (handler)

  Core implementation of move_node tool: retrieves Figma node by ID, validates parameters, updates node position (x, y), and returns updated node information.

  async function moveNode(params) {
    const { nodeId, x, y } = params || {};
  
    if (!nodeId) {
      throw new Error("Missing nodeId parameter");
    }
  
    if (x === undefined || y === undefined) {
      throw new Error("Missing x or y parameters");
    }
  
    const node = await figma.getNodeByIdAsync(nodeId);
    if (!node) {
      throw new Error(`Node not found with ID: ${nodeId}`);
    }
  
    if (!("x" in node) || !("y" in node)) {
      throw new Error(`Node does not support position: ${nodeId}`);
    }
  
    node.x = x;
    node.y = y;
  
    return {
      id: node.id,
      name: node.name,
      x: node.x,
      y: node.y,
    };
  }

• src/talk_to_figma_mcp/server.ts:346-376 (registration)

  MCP server.tool registration for 'move_node', including schema validation with Zod (nodeId, x, y) and handler that forwards to Figma plugin via sendCommandToFigma.

    "move_node",
    "Move a node to a new position in Figma",
    {
      nodeId: z.string().describe("The ID of the node to move"),
      x: z.number().describe("New X position"),
      y: z.number().describe("New Y position")
    },
    async ({ nodeId, x, y }) => {
      try {
        const result = await sendCommandToFigma('move_node', { nodeId, x, y });
        const typedResult = result as { name: string };
        return {
          content: [
            {
              type: "text",
              text: `Moved node "${typedResult.name}" to position (${x}, ${y})`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error moving node: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/talk_to_figma_mcp/server.ts:348-352 (schema)

  Zod input schema for move_node tool parameters: nodeId (string), x (number), y (number).

  {
    nodeId: z.string().describe("The ID of the node to move"),
    x: z.number().describe("New X position"),
    y: z.number().describe("New Y position")
  },

• src/cursor_mcp_plugin/code.js:83-84 (handler)

  Dispatch handler case in Figma plugin code that routes 'move_node' command to the moveNode function.

  case "move_node":
    return await moveNode(params);

• src/talk_to_figma_mcp/server.ts:768-768 (helper)

  Type union FigmaCommand includes 'move_node' for type safety in sendCommandToFigma calls.

  | 'move_node'