Figma MCP Server

/** * Design Modification Tools * MCP tools for modifying design elements (Note: Limited via REST API, may require Plugin API) */ export function registerDesignModificationTools(protocol, figmaClient) { // Update node properties (placeholder - REST API has limited write capabilities) protocol.registerTool("update_node_properties", { description: "Update properties of a design node (Note: Figma REST API has limited write capabilities. Full modification may require Plugin API)", inputSchema: { type: "object", properties: { fileKey: { type: "string", description: "Figma file key", }, nodeId: { type: "string", description: "Node ID to update", }, properties: { type: "object", description: "Properties to update (structure depends on node type)", }, }, required: ["fileKey", "nodeId"], }, handler: async (args) => { const { fileKey, nodeId, properties } = args; // Note: Figma REST API has very limited write capabilities // Most modifications require the Plugin API or manual editing // This tool provides information about the node and limitations try { const nodeData = await figmaClient.getFileNodes(fileKey, [nodeId]); const node = nodeData.nodes[nodeId]; return { fileKey, nodeId, currentNode: node ? { id: node.document.id, name: node.document.name, type: node.document.type, } : null, message: "Figma REST API has limited write capabilities. For full design modification, please use:", options: [ "Figma Plugin API for programmatic modifications", "Figma web interface for manual edits", "Figma REST API webhooks for event-driven updates", ], requestedProperties: properties, note: "Consider using the Plugin API or webhooks for comprehensive design modifications", }; } catch (error) { throw new Error( `Failed to retrieve node information: ${error.message}`, ); } }, }); // Get node information for modification planning protocol.registerTool("get_node_for_modification", { description: "Get detailed node information to plan modifications (useful before using Plugin API)", inputSchema: { type: "object", properties: { fileKey: { type: "string", description: "Figma file key", }, nodeId: { type: "string", description: "Node ID", }, includeGeometry: { type: "boolean", description: "Include geometry information", default: true, }, }, required: ["fileKey", "nodeId"], }, handler: async (args) => { const { fileKey, nodeId, includeGeometry = true } = args; const nodeData = await figmaClient.getFileNodes(fileKey, [nodeId], { geometry: includeGeometry, }); const node = nodeData.nodes[nodeId]?.document; if (!node) { throw new Error(`Node ${nodeId} not found`); } return { fileKey, nodeId, node: { id: node.id, name: node.name, type: node.type, visible: node.visible, locked: node.locked, ...(includeGeometry && { absoluteBoundingBox: node.absoluteBoundingBox, relativeTransform: node.relativeTransform, }), fills: node.fills, strokes: node.strokes, effects: node.effects, characters: node.characters, style: node.style, }, modificationGuidance: { restApiLimitations: "REST API has limited write capabilities", recommendedApproach: "Use Figma Plugin API for programmatic modifications", alternative: "Use webhooks for event-driven updates", }, }; }, }); }