{"_id":"mcp-figma","_rev":"1-f6df0cb2af4030ffe1f56bfbf3ceca93","name":"mcp-figma","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"mcp-figma","version":"0.1.0","keywords":["figma","api","mcp","model-context-protocol"],"author":{"name":"Noah"},"license":"MIT","_id":"mcp-figma@0.1.0","maintainers":[{"name":"noahhh1005","email":"hjhao0802@gmail.com"}],"homepage":"https://github.com/noahcn/mcp-figma#readme","bugs":{"url":"https://github.com/noahcn/mcp-figma/issues"},"bin":{"mcp-figma":"build/index.js"},"dist":{"shasum":"b6e68192a72cc850118aa0997e8a9036efa2aa72","tarball":"https://registry.npmjs.org/mcp-figma/-/mcp-figma-0.1.0.tgz","fileCount":21,"integrity":"sha512-xuils4cxW8mk3EdPdZc48BBJFmoC1mISFDhdwCe/naftoJvFj09ObXF6OlPR4Ty6vhHOvCg+RiqdzbnFIBpd7g==","signatures":[{"sig":"MEUCIQC9JP8Nu4yukPlJPftN4df9thzv7bSL9Wb+nfoSNKHnCQIgbaEqCK1tPXi8d39u+1rV+YJkQ1U77hRKRGlZatqmFSc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46324},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"scripts":{"build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"noahhh1005","email":"hjhao0802@gmail.com"},"repository":{"url":"git+https://github.com/noahcn/mcp-figma.git","type":"git"},"_npmVersion":"10.8.2","description":"Figma MCP server for accessing Figma API","directories":{},"_nodeVersion":"20.18.1","dependencies":{"zod":"^3.22.4","axios":"^1.6.2","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.2","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-figma_0.1.0_1741001172282_0.05766035641976641","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"mcp-figma","version":"0.1.1","description":"Figma MCP server for accessing Figma API","main":"build/index.js","type":"module","bin":{"mcp-figma":"build/index.js"},"scripts":{"build":"tsc","start":"node build/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^0.4.0","axios":"^1.6.2","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.2"},"keywords":["figma","api","mcp","model-context-protocol"],"author":{"name":"Noah"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/noahcn/mcp-figma.git"},"bugs":{"url":"https://github.com/noahcn/mcp-figma/issues"},"homepage":"https://github.com/noahcn/mcp-figma#readme","engines":{"node":">=16.0.0"},"_id":"mcp-figma@0.1.1","gitHead":"6ac58a2f7ceb09cded0d2f5b2e400c1555d7c398","types":"./build/index.d.ts","_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-CCthH+GIH8GncTGqsIZasybhXdKHOtRLOZ42Mz2KprTNWpOCEiKFX/Q2W6PkWxAhi58v5D1u5red2Pn4QcpGzg==","shasum":"a86734ec2d20c56f663359a17cbee92fade7ff3c","tarball":"https://registry.npmjs.org/mcp-figma/-/mcp-figma-0.1.1.tgz","fileCount":21,"unpackedSize":49785,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCl7c0gzRN8/pUqfG6Jk7cYc/12CtD46D40gc3hra9ngQIgICsV5Bcz1jJkIia8KqtAqqs16NLQYDjHEUYwXHYHbRY="}]},"_npmUser":{"name":"noahhh1005","email":"hjhao0802@gmail.com"},"directories":{},"maintainers":[{"name":"noahhh1005","email":"hjhao0802@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-figma_0.1.1_1741006593317_0.46301159426286675"},"_hasShrinkwrap":false}},"time":{"created":"2025-03-03T11:26:12.281Z","modified":"2025-03-03T12:56:33.682Z","0.1.0":"2025-03-03T11:26:12.488Z","0.1.1":"2025-03-03T12:56:33.515Z"},"bugs":{"url":"https://github.com/noahcn/mcp-figma/issues"},"author":{"name":"Noah"},"license":"MIT","homepage":"https://github.com/noahcn/mcp-figma#readme","keywords":["figma","api","mcp","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/noahcn/mcp-figma.git"},"description":"Figma MCP server for accessing Figma API","maintainers":[{"name":"noahhh1005","email":"hjhao0802@gmail.com"}],"readme":"# mcp-figma\n\nA Model Context Protocol (MCP) server for Figma API integration, designed to be used with Claude and other MCP-compatible AI assistants.\n\n[![npm version](https://badge.fury.io/js/mcp-figma.svg)](https://www.npmjs.com/package/mcp-figma)\n[![smithery badge](https://smithery.ai/badge/@ai-zerolab/mcp-figma)](https://smithery.ai/server/@ai-zerolab/mcp-figma)\n\n## Features\n\nThis MCP server provides access to Figma API functionality:\n\n- File operations (get file, get nodes, get images)\n- Comments management\n- Team/project management\n- Components and styles access\n- Persistent API key storage\n\n## Installation\n\n### Installing via Smithery\n\nTo install mcp-figma for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ai-zerolab/mcp-figma):\n\n```bash\nnpx -y @smithery/cli install @ai-zerolab/mcp-figma --client claude\n```\n\n### NPM Installation\n\n```bash\n# Install globally\nnpm install -g mcp-figma\n\n# Or install locally in a project\nnpm install mcp-figma\n\n# Update to latest version\nnpm update -g mcp-figma\n```\n\n## Usage with Claude\n\n1. Add mcp-figma to your Claude configuration:\n\n```json\n\"mcp-figma\": {\n  \"command\": \"npx\",\n  \"args\": [\n    \"-y\",\n    \"mcp-figma\"\n  ]\n}\n```\n\n2. Get your Figma API key:\n   - Log in to your Figma account\n   - Go to Account Settings (click your profile picture > Settings)\n   - Go to the \"Personal access tokens\" section\n   - Click \"Create a new personal access token\"\n   - Enter a name for your token and click \"Create token\"\n   - Copy your token (starts with \"figd_\")\n\n3. When using Claude, the first time you'll need to set your Figma API key:\n\n```\nPlease use mcp-figma to set my Figma API key: figd_xxxxxxxxxxxxxxxxxxxxxxx\n```\n\nYour API key will be stored in `~/.mcp-figma/config.json` and will be automatically loaded in future sessions.\n\n3. You can verify your API key is configured:\n\n```\nPlease use mcp-figma to check my API key status\n```\n\n4. Then use any of the available Figma API functions:\n\n```\nPlease use mcp-figma to get the file with key abc123\n```\n\n## Available Tools\n\nThe server provides the following tools:\n\n- `set_api_key`: Set your Figma API personal access token (saved to config)\n- `check_api_key`: Check if an API key is already configured\n- `get_file`: Get a Figma file by key\n- `get_file_nodes`: Get specific nodes from a Figma file\n- `get_image`: Get images for nodes in a Figma file\n- `get_image_fills`: Get URLs for images used in a Figma file\n- `get_comments`: Get comments on a Figma file\n- `post_comment`: Post a comment on a Figma file\n- `delete_comment`: Delete a comment from a Figma file\n- `get_team_projects`: Get projects for a team\n- `get_project_files`: Get files for a project\n- `get_team_components`: Get components for a team\n- `get_file_components`: Get components from a file\n- `get_component`: Get a component by key\n- `get_team_component_sets`: Get component sets for a team\n- `get_team_styles`: Get styles for a team\n- `get_file_styles`: Get styles from a file\n- `get_style`: Get a style by key\n\nFor detailed usage examples, see [USAGE.md](./USAGE.md).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}