figma-create-new-file

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 plan and product

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.
• Multiple plans: show the available plans, ask the user to select one and then use that plan's key.

Infer the product (Design, FigJam, or Slides) from the task. If unclear, ask the user to specify.

Step 2: Call createnewfile

• Call the create_new_file tool with the planKey and product from Step 1.
• Use a concise name for the new file if the user doesn't provide one.
• Use the file_key from the create_new_file tool response for subsequent tool calls like use_figma.

Step 3: (Slides only) Handle the empty grid

A new Slides file contains no slides: figma.getSlideGrid() returns []. Before reading properties such as theme tokens from a slide, call figma.createSlide() or handle the empty case. The first createSlide() call automatically creates row 0 and inserts the slide.