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:
User already provided a planKey
(e.g. from a previous
whoami
call or in their prompt) → use it directly, skip to Step 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.