Figma Comments MCP Server

A Model Context Protocol (MCP) server for managing Figma comments directly from your IDE. Designed specifically for integration with Claude Desktop and other MCP-compatible development environments.

✨ Features

Core Comment Operations

• Get Comments: Retrieve all comments from a Figma file
• Post Comments: Add new comments to specific locations
• Reference Comments: Create new comments that reference existing ones (using parent_id)
• Delete Comments: Remove existing comments

Advanced Filtering & Analysis

• Filter by Page: Find comments on specific pages
• Filter by Author: Find comments by specific users
• Filter by Date Range: Find comments within date ranges
• Get Unresolved Comments: Find all unresolved comments
• Get Comment Threads: Organize comments into conversation threads
• Export to CSV: Export comments data for analysis

🚀 Quick Setup for IDE

1. Get Figma Token

Get your Personal Access Token from Figma Account Settings

2. Configure Your IDE

Add to your MCP configuration (e.g., claude_desktop_config.json for Claude Desktop, or equivalent for Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "Figma Comments MCP Server": {
      "command": "npx",
      "args": [
        "[email protected]",
        "--figma-api-key",
        "YOUR_FIGMA_API_KEY"
      ],
      "env": {
        "LOG_LEVEL": "info",
        "DEBUG": "false"
      }
    }
  }
}

3. Restart Your IDE

Restart your IDE to load the MCP server.

🛠️ Available Tools

get_figma_comments

Retrieve all comments from a Figma file.

{"file_key": "abcdefghijklmnopqrstuv"}

post_figma_comment

Add a new comment to a Figma file. Note: parent_id creates a new standalone comment that references another comment, not a threaded reply.

New Comment:

{
  "file_key": "abcdefghijklmnopqrstuv",
  "message": "This needs to be updated",
  "clientMeta": {
    "x": 100,
    "y": 200
  }
}

Comment Referencing Another:

{
  "file_key": "abcdefghijklmnopqrstuv",
  "message": "I agree, let's fix this",
  "parent_id": "123456789"
}

delete_figma_comment

Delete a specific comment.

{
  "file_key": "abcdefghijklmnopqrstuv",
  "comment_id": "123456789"
}

filter_comments_by_page

Filter comments by a specific page in a Figma file.

{
  "fileKey": "abcdefghijklmnopqrstuv",
  "pageId": "123:456"
}

filter_comments_by_author

Filter comments by a specific author.

{
  "fileKey": "abcdefghijklmnopqrstuv",
  "authorId": "user123456"
}

filter_comments_by_date_range

Filter comments by date range.

{
  "fileKey": "abcdefghijklmnopqrstuv",
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z"
}

get_unresolved_comments

Get all unresolved comments from a Figma file.

{
  "fileKey": "abcdefghijklmnopqrstuv"
}

get_comment_threads

Get comment threads (grouped by parent comments) from a Figma file.

{
  "fileKey": "abcdefghijklmnopqrstuv"
}

export_comments_to_csv

Export comments from a Figma file to CSV format.

{
  "fileKey": "abcdefghijklmnopqrstuv",
  "outputPath": "my_comments.csv"
}

📋 Using Figma Files

You can work with Figma files in two ways:

Option 1: Use the file key directly

{"file_key": "abc123def456"}

Option 2: Send the full Figma URL You can send any Figma URL - the MCP server will extract the file key automatically:

• File URL: https://www.figma.com/file/abc123def456/my-design
• Selection URL: https://www.figma.com/file/abc123def456/my-design?node-id=123%3A456
• Any other Figma file link

The file key is the 22-character identifier in the URL after /file/.

🐛 Troubleshooting

"Unauthorized" errors: Check your Figma token is valid and has necessary permissions.

"File not found" errors: Ensure the file key is correct (22 characters) and accessible.

Connection issues: Verify internet connection and Figma API accessibility.

Debug mode: Set LOG_LEVEL=DEBUG environment variable for detailed logging.

📚 Resources

• Figma REST API
• Model Context Protocol
• Claude Desktop Configuration

Recent Updates

Version 1.5.0

• Advanced Filtering: Added filter_comments_by_page, filter_comments_by_author, and filter_comments_by_date_range tools
• Comment Analysis: Added get_unresolved_comments and get_comment_threads for better comment organization
• Data Export: Added export_comments_to_csv for exporting comment data to CSV format
• Enhanced Workflow: New tools enable comprehensive comment management and analysis workflows

Version 1.4.0

• API Accuracy: Removed non-functional comment reaction features that aren't supported by Figma's API
• Clarified Threading: Updated documentation to clarify that parent_id creates standalone comments, not threaded replies
• Streamlined Tools: Focused on core functionality that actually works with Figma's REST API
• Improved Documentation: Updated all examples and descriptions to reflect actual API behavior

📄 License

MIT