Figma Comments MCP

A lightweight Model Context Protocol (MCP) server that adds Figma Comments support to AI assistants such as Claude.

The official Figma MCP provides excellent support for reading and editing designs, but it does not expose Figma comments. This project fills that gap by allowing AI assistants to read, query, and reply to comments using the Figma REST API.

Note: This project is designed to work alongside the official Figma MCP, not replace it.

✨ Features

📋 List all comments in a Figma file
🔍 Query comments by:
- Node ID
- Resolved / Unresolved status
- Keyword
💬 Reply to existing comments
⚡ Lightweight and easy to extend
🤖 Built using the official Model Context Protocol (MCP) SDK

Example Workflow

Using the Official Figma MCP + Figma Comments MCP, Claude can:

Read a selected frame.
Retrieve comments attached to that frame.
Understand the requested changes.
Modify the design.
Reply to the comment once the changes have been completed.

This creates an end-to-end AI-powered design review workflow.

Available Tools

`list_comments`

Returns all comments from the configured Figma file.

`get_unresolved_comments`

Returns only unresolved comments.

`query_comments`

Returns comments using optional filters.

Parameters

Name	Type	Description
nodeId	string	Filter by Figma Node ID
resolved	boolean	Filter resolved/unresolved comments
contains	string	Search comments by keyword

Example:

{
  "nodeId": "114:24499",
  "resolved": false
}

`reply_comment`

Replies to an existing Figma comment.

Parameters

{
  "commentId": "1825600097",
  "message": "Implemented. Please review."
}

Project Structure

figma-comments-mcp/
│
├── src/
│   ├── config/
│   │   └── env.ts
│   │
│   ├── figma/
│   │   ├── client.ts
│   │   └── comments.ts
│   │
│   ├── services/
│   │   └── commentService.ts
│   │
│   └── server.ts
│
├── .env
├── package.json
└── tsconfig.json

Installation

Clone the repository

git clone https://github.com/<your-username>/figma-comments-mcp.git

Install dependencies

npm install

Create a .env file

FIGMA_TOKEN=your_figma_personal_access_token
FIGMA_FILE_KEY=your_figma_file_key

Start the MCP server

npm run dev

Requirements

Node.js 20+
Figma Personal Access Token
Figma File Key

Tech Stack

TypeScript
Node.js
Axios
Model Context Protocol SDK
Figma REST API

Roadmap

List comments
Query comments
Reply to comments
Remote HTTP MCP support
Claude.ai Connector support
Better formatted responses
Unit tests
GitHub Actions CI/CD

Contributing

Contributions, issues, and feature requests are welcome.

If you'd like to improve the project, feel free to open an issue or submit a pull request.

License

MIT License

Acknowledgements

Anthropic for the Model Context Protocol (MCP)
Figma for the REST API
The official Figma MCP team for providing the design-side functionality that this project complements.

Figma Comments MCP