Skip to content

Figma Integration

STATUS: active OWNER: alexander (primary), floris, floor (consumers) CATEGORY: integration ADDED: 2026-03-27

WHAT

Figma design platform integration via Framelink MCP server (figma-developer-mcp). Read-only design-to-code translation: fetches design data from Figma files and simplifies API responses by ~90% for LLM consumption.

  • Official Figma MCP requires Dev Mode license ($35/seat/month minimum)
  • Framelink works with any Figma Personal Access Token (free)
  • Framelink is read-only — safer for automated agents (no accidental writes)
  • 347K downloads/month, battle-tested, 14K GitHub stars
  • Official Figma MCP can be added later for write operations if needed

MCP SERVER

  • Package: figma-developer-mcp (npm)
  • Version: 0.8.0 (2026-03-24)
  • GitHub: github.com/GLips/Figma-Context-MCP
  • License: MIT

Tools Available

Tool Description
get_figma_data Fetches design data (layout, content, visuals, components). Params: fileKey, nodeId, depth. Returns compressed YAML/JSON.
download_figma_images Downloads SVG/PNG/GIF from nodes. Params: fileKey, nodes[], pngScale, localPath.

Configuration

MCP config at: /ge-ops/master/mcp-configs/alexander.json API key in Vault at: admin-ui/api-keys → figma key

Auth

Figma Personal Access Token with "File content" scope (Read). Generate at: figma.com/settings → Personal Access Tokens. Store in Vault as FIGMA_API_KEY.

RATE LIMITS

Depends on Figma plan: - Starter: 6 read calls/month (useless) - Pro (Full/Dev seat): Tier 1: 15/min, Tier 2: 50/min, Tier 3: 100/min - Enterprise: Unlimited

GE needs at minimum a Pro plan with Full or Dev seat.

KNOWN ISSUES

  • 429 rate limits on heavy use (implement backoff)
  • Large frames can be slow (use nodeId to scope requests)
  • Framelink is read-only — cannot create/edit designs

IMAGE HANDLING (CRITICAL)

download_figma_images saves files to disk at localPath. This is SAFE — images never enter the conversation context. Alexander should ALWAYS use localPath parameter to save images to the work directory, never request inline base64.

See: pitfalls/mcp-integration.md → IMAGE CORRUPTION section.

CHANGELOG MONITORING

Joshua monitors figma-developer-mcp for updates. See: ge_agent/execution/mcp_integration.py → MONITORED_PACKAGES

  • Design system engineering: domains/design/design-system-engineering.md
  • Figma handoff: domains/design/figma-handoff.md
  • MCP pitfalls: development/pitfalls/mcp-integration.md
  • Stitch integration: development/integrations/google-stitch.md