Skill: create_new_file — Create a New Figma File

tip

You can install this skill as a plugin for Claude Code or Cursor from our GitHub repository at github.com/figma/mcp-server-guide.

Use the create_new_file MCP tool to create a new blank Figma file in the user's drafts folder. This is typically used before use_figma when you need a fresh file to work with.

Skill Arguments

This skill accepts optional arguments: /figma-create-new-file [editorType] [fileName]

• editorType: design (default) or figjam
• fileName: Name for the new file (defaults to "Untitled")

Examples:

• /figma-create-new-file — creates a design file named "Untitled"
• /figma-create-new-file figjam My Whiteboard — creates a FigJam file named "My Whiteboard"
• /figma-create-new-file design My New Design — creates a design file named "My New Design"

Parse the arguments from the skill invocation. If editorType is not provided, default to "design". If fileName is not provided, default to "Untitled".

Workflow

Step 1: Resolve the planKey

The create_new_file tool requires a planKey parameter. Follow this decision tree:

1. User already provided a planKey (e.g. from a previous whoami call or in their prompt) → use it directly, skip to Step 2.

2. No planKey available → call the whoami tool. The response contains a plans array. Each plan has a key, name, seat, and tier.

   • Single plan: use its key field automatically.
   • Multiple plans: ask the user which team or organization they want to create the file in, then use the corresponding plan's key.

Step 2: Call create_new_file

Call the create_new_file tool with:

Parameter	Required	Description
planKey	Yes	The plan key from Step 1
fileName	Yes	Name for the new file
editorType	Yes	"design" or "figjam"

Example:

{
  "planKey": "team:123456",
  "fileName": "My New Design",
  "editorType": "design"
}

Step 3: Use the result

The tool returns:

• file_key — the key of the newly created file
• file_url — a direct URL to open the file in Figma

Use the file_key for subsequent tool calls like use_figma.

Important Notes

• The file is created in the user's drafts folder for the selected plan.
• Only "design" and "figjam" editor types are supported.
• If use_figma is your next step, load the figma-use skill before calling it.