figma avatar

Figma Create New File

This is the mandatory first step before creating any new Figma file through Claude. It wraps the create_new_file MCP tool and handles the planKey resolution dance, whether you're spinning up a design file, FigJam board, or Slides deck. The skill parses optional arguments for editor type and file name, figures out which team or org to bill it to (calling whoami if needed), then returns a file_key you can hand off to use_figma. One gotcha worth knowing: Slides files start with a completely empty grid, no default first slide, so your follow-up scripts need to either guard for that or create a slide before trying to read theme tokens or other properties.

skills.sh installs
3.7K
GitHub stars
2.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add figma/mcp-server-guide --skill figma-create-new-file --agent claude-code

Installs into .claude/skills of the current project.

Files

Create a new file in Figma

Steps to create a new Figma Design, FigJam, or Slides file using the create_new_file MCP tool.

Step 1: Resolve the planKey and editorType

Use the planKey the user provided or selected for this task. Otherwise, call whoami and inspect the returned plans.

  • No plans: inform the user that file creation cannot proceed.
  • One plan: use its key as planKey.
  • Multiple plans: show the available plans, ask the user to select one and then use that plan's key as planKey.

Infer editorType from the requested file type by choosing from the tool's advertised input enum. If unclear, ask the user to specify the file type.

Step 2: Call create_new_file

Call the create_new_file tool with all three required arguments:

  • fileName: Required. Choose a concise name if the user does not provide one.
  • planKey: Required. Use the planKey resolved in Step 1.
  • editorType: Required. Use the editorType selected in Step 1.
  • projectId: Optional. Set it to create the file in a specific project.
{
  "fileName": "Quarterly planning",
  "planKey": "team::1234567890",
  "editorType": "design"
}

Sponsors

Details

Repository
github.com/figma/mcp-server-guide
Categories
Backend & APIs, Git & Pull Requests, Documentation, Code Review & Quality, AI & Agent Building, Design & UI/UX, Office & Documents
First seen
Apr 16, 2026

More from figma/mcp-server-guide

All 14
1figma avatarfigma-code-connectfigma/mcp-server-guideCreates and maintains Figma Code Connect template files that map Figma components to code snippets. Use when the user mentions Code Connect, Figma component map3.6Kskills.sh installs
2figma avatarfigma-use-figjamfigma/mcp-server-guideThis skill helps agents use Figma's use_figma MCP tool in the FigJam context. Can be used alongside figma-use which has foundational context for using the use_f2.2Kskills.sh installs
3planetscale avatarnekiplanetscale/database-skillsOverview and information about Neki, the sharded Postgres product by PlanetScale. Load when working with Neki-related tasks and the need to scale or shard postg1.7Kskills.sh installs
4sbroenne avatarexcel-mcpsbroenne/mcp-server-excelExcel MCP Server skill for Windows workbook automation. Use when an assistant needs rich MCP tools to create, inspect, modify, format, or analyze Excel files. S1.7Kskills.sh installs
5figma avatarfigma-create-design-system-rulesfigma/mcp-server-guideGenerates custom design system rules for the user's codebase. Use when user says "create design system rules", "generate rules for my project", "set up design r1.6Kskills.sh installs
6figma avatarcreate-design-system-rulesfigma/mcp-server-guideGenerates custom design system rules for the user's codebase. Use when user says "create design system rules", "generate rules for my project", "set up design r1.3Kskills.sh installs