# figma-developer-docs-mcp

An MCP (Model Context Protocol) server that provides AI coding assistants with structured access to the complete Figma developer documentation.

## Coverage

| Section | Pages | Content |
|---------|-------|---------|
| Plugin API | 450 | Node types, properties, methods, guides |
| Widget API | 78 | Components, hooks, types, guides |
| REST API | 51 | Endpoints, authentication, webhooks, SCIM |
| Figma MCP Server | 23 | Setup, tools, troubleshooting |
| Code (Figma Make) | 19 | Code layers, properties, guidelines |
| Code Connect | 18 | React, SwiftUI, Compose, CI/CD |
| Embeds | 8 | Embed kit, security, API |
| **Total** | **649** | |

## Usage

### With Claude Code

```bash
claude mcp add figma-developer-docs -- npx figma-developer-docs-mcp
```

### With Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "figma-developer-docs": {
      "command": "npx",
      "args": ["figma-developer-docs-mcp"]
    }
  }
}
```

### With any MCP client

```bash
npx figma-developer-docs-mcp
```

The server communicates over stdio using the MCP protocol.

## Tools

### `read-figma-developer-docs-index`

Returns the full documentation index — all sections and page listings. Use this first to discover what's available.

### `read-figma-developer-docs-pages`

Reads specific documentation pages by path. Accepts an array of paths from the index.

```
paths: ["/docs/plugins/api/TextNode", "/docs/plugins/working-with-text"]
```

### `search-figma-developer-docs`

Full-text search across all documentation. Returns matching pages with excerpts.

```
query: "createImage"
section: "plugins"  // optional: limit to a section
maxResults: 10      // optional
```

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Re-scrape documentation (requires internet)
npm run scrape

# Run locally
node dist/index.js
```

## How it works

The documentation is scraped from [developers.figma.com](https://developers.figma.com) and converted to Markdown files organized by section. The MCP server reads these files on demand and serves them through three tools: index, read, and search.

The scraped docs are included in the npm package so the server works offline with no network requests.

## License

MIT