{"id":50939055,"url":"https://github.com/gridonic/figma-mcp","last_synced_at":"2026-06-17T12:01:29.691Z","repository":{"id":352835522,"uuid":"1216833749","full_name":"gridonic/figma-mcp","owner":"gridonic","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-08T14:32:23.000Z","size":358,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-08T16:23:03.740Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gridonic.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-21T09:23:30.000Z","updated_at":"2026-06-08T14:34:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gridonic/figma-mcp","commit_stats":null,"previous_names":["gridonic/figma-mcp"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/gridonic/figma-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridonic%2Ffigma-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridonic%2Ffigma-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridonic%2Ffigma-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridonic%2Ffigma-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gridonic","download_url":"https://codeload.github.com/gridonic/figma-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gridonic%2Ffigma-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34447266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-17T12:01:22.824Z","updated_at":"2026-06-17T12:01:29.679Z","avatar_url":"https://github.com/gridonic.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# figma-mcp\n\n`figma-mcp` packages a reusable **Figma MCP to Astro workflow** so you can install it in any project.\n\n- **Cursor rules** — module generation and design implementation (`.cursor/rules/`)\n- **CLI** — cache management, token sync, and setup (`npx figma-mcp`)\n- **Scripts** — `figma-cache.ts`, `sync-design-tokens.ts`, `modules-setup.ts`\n- **Config template** — `templates/figma.config.yaml`\n\n## Quick start\n\n```bash\nnpm install figma-mcp@github:gridonic/figma-mcp\nnpx figma-mcp init\n```\n\nIn `.cursor/mcp/figma.config.yaml`:\n\n1. Set your source (bridge is recommended — bypasses rate limits):\n\n```yaml\n# Bridge — bypasses rate limits; one-time plugin setup required\nsource: bridge\n\n# Desktop — requires Figma Desktop running with MCP enabled\nsource: desktop\n```\n\n2. Fill in your Figma URLs (`styleguide.*` and `modules.*` entries).\n\n3. If using bridge, complete the one-time plugin setup: [docs/bridge-setup.md](docs/bridge-setup.md).\n\n4. Warm cache:\n\n```bash\nnpx figma-mcp cache warm --refresh\n```\n\n## Workflow\n\nPrepare cache, tokens, and scaffolding before running the generation agent:\n\n```bash\nnpm run figma-mcp -- cache warm --refresh\nnpm run figma-mcp -- tokens sync --refresh\nnpm run figma-mcp -- modules setup\n```\n\nThen invoke the module-generation rule in Cursor for one module or all managed modules.\n\nTo fetch a missing child-node artifact:\n\n```bash\nnpm run figma-mcp -- cache get --url \"\u003cfigma-url\u003e\" --node \u003cchild-node-id\u003e --tool get_design_context\n```\n\n\u003e **Note:** `tokens sync` requires marker blocks in `src/sass/root/_colors.scss` and `src/sass/typography/_font-types.scss`:\n\u003e\n\u003e ```scss\n\u003e // @figma-tokens:colors:start\n\u003e // @figma-tokens:colors:end\n\u003e\n\u003e // @figma-tokens:font-types:start\n\u003e // @figma-tokens:font-types:end\n\u003e ```\n\n## CLI commands\n\n```text\nnpx figma-mcp init\nnpx figma-mcp upgrade [--rules-only]\nnpx figma-mcp bridge setup [--refresh]\nnpx figma-mcp bridge status\nnpx figma-mcp cache warm [--refresh]\nnpx figma-mcp cache inspect [module] [--json]\nnpx figma-mcp cache get --url \u003curl\u003e --node \u003cnodeId\u003e [--tool \u003ctool\u003e]\nnpx figma-mcp cache list|clear\nnpx figma-mcp tokens sync [--refresh]\nnpx figma-mcp modules setup\nnpx figma-mcp info|help\n```\n\n## License\n\nISC\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridonic%2Ffigma-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgridonic%2Ffigma-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgridonic%2Ffigma-mcp/lists"}