Skip to content
Back to search

figma-mcp-server

Figma Model Context protocol server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/antonytm--figma-mcp-server/badge.svg)](/listings/antonytm--figma-mcp-server)

HTML

<a href="/listings/antonytm--figma-mcp-server"><img src="/api/listings/antonytm--figma-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Figma Model Context protocol server
  2. [![Community Figma MCP server - Allow AI Agents to help you with Figma designs! | Product Hunt](https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1056256&amp;theme=light&amp;period=daily&amp;t=1767540612947)](https://www.producthunt.com/products/community-figma-mcp-server?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-community-figma-mcp-server)
  3. ## Problem
  4. The official Figma MCP server has only read-only tools. **You can not change anything in the Figma document using the official Figma MCP server.**
  5. You can use AI Agent in Figma Make. But, it is not convenient to chat in Figma Make and then move result to Figma to continue.
  6. **The goal is to enable AI Agents to work with your Figma documents.**
  7. You are able to ask you AI agent to implement the design in Figma that you want with this MCP server!
  8. ## Usage
  9. ### Prerequisites
  10. 1. Install `Node.js` if you don't have it
  11. 2. Clone this repository
  12. ### Start Figma Plugin
  13. 1. Switch to plugin directory: `cd plugin`
  14. 2. Install dependencies: `npm i`
  15. 3. Build Figma Plugin `npm run build`
  16. 4. Open Figma, open document you want to work with
  17. 5. Add Figma Plugin *Plugins* > *Development* > *Imprort Plugin from manifest*, select `/plugin/manifest.json`
  18. 6. Start the *Figma MCP Server* plugin
  19. 7. Expected result: Message *Not connected to MCP server* should be shown
  20. 8. Do not close Plugin window. It will show message *Connected to MCP server* when it is started.
  21. Next time you can start plugin from: *Plugins* > *Development* > *Figma MCP Server*. And do 1-3 steps only when you want to get latest changes.
  22. ### Start MCP server
  23. 1. Switch to MCP directory: `cd mcp`
  24. 2. Install dependencies: `npm i`
  25. 3. Start the server: `npm run start`
  26. 4. Expected result: Messages `Server listening on http://localhost:38450` and `a user connected: .............` in the console
  27. ### Configure MCP server in your client
  28. 1. Use Streaming HTTP transport and `http://localhost:38450/mcp` URL
  29. 2. Turn off tools that you don't need
  30. Now you should be able to ask your AI Agent to do something in Figma. For example:
  31. ![Claude](doc/Claude.png)
  32. ![Figma](doc/Figma.png)
  33. **We are working on publishing it as Figma plugin. Figma reviewers haven't accepted it so far.**
  34. Once Figma accept it as plugin, the configuration and start will be simplified a lot!
  35. ## Tools
  36. TBD
  37. ## Development
  38. Contributions to the project are welcome!
  39. ### MCP server
  40. 1. `cd mcp`
  41. 2. `npm i`
  42. 3. `npm run dev`
  43. ### Plugin
  44. 1. `cd plugin`
  45. 2. `npm i`
  46. 3. `npm run dev`
  47. 4. Open Figma
  48. 5. Plugins > Development > Import plugin from manifest ...
  49. 6. Select `manifest.json` from `plugin\manifest.json`
  50. 7. Start plugin
  51. 8. You should see *Connected to MCP server* message
  52. ### Add Plugin to Figma
  53. 1. Open Figma
  54. 2. Add Figma Plugin *Plugins* > *Development* > *Imprort Plugin from manifest*, select `/plugin/manifest.json`
  55. ### Inspector
  56. 1. `cd mcp`
  57. 2. `npm run inspector`
  58. 3. Use `http://127.0.0.1:38450/mcp` to connect
  59. ## Architecture
  60. WebSockets server is used as a medium to transfer messages between MCP Server and Figma Plugin.
  61. MCP server starts *Express.js* server with MCP endpoints and WebSockets *socket.io* server for communication with Plugin.
  62. MCP server save tool calls into the queue and send message to WebSockets server.
  63. Figma Plugin listen to the WebSocket server. And if there are any tasks to do, it takes them, do required actions, and return the result.
  64. MCP server listen to the WebSockets server. If there are any messages from Figma plugin then it processes them. It found the apropriacte tool call in the queue. And executes the promise with the result from Figma plugin. If any of tool calls are executed for too long then it returns timeout wihtout waiting for the response.
  65. ![Architecture](doc/figma-mcp-architecture.png)
  66. ![Sequence](doc/figma-mcp-sequence.svg)
  67. ## Security
  68. Plugin gives access to your design document for external systems: AI Agents that you will connect. It acts as a bridge in the similar way as the official Figma MCP server. And, similar to the official MCP server it works on local machine and do not expose any information to the networks.
  69. If you want to use it in the network, please do it on your own risk.
  70. If you found any security issue, please report it via GitHub issue.
  71. ## Alternatives
  72. If your tasks could be done by [official Figma MCP server](https://help.figma.com/hc/en-us/articles/32132100833559-Guide-to-the-Figma-MCP-server), please use it.
  73. Before starting this project, I made a search for my idea to implement Figma MCP server using Figma plugin and sockets as protocol for communication. And I found [this one](https://github.com/grab/cursor-talk-to-figma-mcp). Initially, I thought to fork it and change for my needs. But, there are few things that I don't like: requirement to run separate server for socket, everything located in one file, very hard to maintain, JavaScript(not TypeScript or Python). But, you always can consider that server as an alternative.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.