This project enables programmatic interaction between Cursor AI and Figma, allowing AI models to read and modify Figma designs. It targets AI developers and designers seeking to automate design tasks, offering benefits like bulk content replacement and instance override propagation.

How It Works

The system comprises a TypeScript-based Model Context Protocol (MCP) server that integrates with Cursor AI, and a Figma plugin that communicates with this server via a WebSocket. Cursor AI sends design instructions to the MCP server, which translates them into Figma API calls executed by the plugin. This architecture facilitates AI-driven design manipulation.

Quick Start & Requirements

• Install Bun: curl -fsSL https://bun.sh/install | bash
• Setup MCP: bun setup
• Start WebSocket server: bun socket
• Run MCP server: bunx cursor-talk-to-figma-mcp NEW
• Install Figma plugin locally or from Figma Community.
• For Windows/WSL, uncomment hostname: "0.0.0.0" in src/socket.ts.

Highlighted Details

• Supports a wide range of Figma operations: document info, selection, node manipulation, styling, auto-layout, components, and exporting.
• Includes MCP tools for creating elements (rectangles, frames, text), modifying text content, and managing auto-layout properties.
• Offers advanced features like converting prototype reactions to connector lines and propagating component instance overrides.
• Provides helper prompts for design strategy, text replacement, and annotation conversion.

Maintenance & Community

Contributions noted from @dusskapark. Links to community channels or roadmaps are not present in the README.

Licensing & Compatibility

MIT License. Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

Image export functionality is currently limited, returning base64 as text. The project appears to be actively developed with community contributions, but a formal roadmap or extensive community support channels are not detailed.