create_text

Auto-generate your docs

Overview

Create a new text element in Figma with specified position, content, and optional styling properties.

Parameters

Position & Content

number

required

X position of the text element

number

required

Y position of the text element

string

required

Text content to display

Styling Properties

number

Font size in pixels. Defaults to 14 if not provided.

number

Font weight (e.g., 400 for Regular, 700 for Bold). Defaults to 400 if not provided.Common values:

100: Thin
200: Extra Light
300: Light
400: Regular/Normal
500: Medium
600: Semi Bold
700: Bold
800: Extra Bold
900: Black

object

Font color in RGBA format. Defaults to black {r: 0, g: 0, b: 0, a: 1} if not provided.Properties:

r (number, 0-1): Red component
g (number, 0-1): Green component
b (number, 0-1): Blue component
a (number, 0-1, optional): Alpha/opacity component

Other Properties

string

Semantic layer name for the text node. Defaults to “Text” if not provided.

string

Optional parent node ID to append the text to. If not provided, the text is created in the current selection or page.

Return Type

Returns an object with:

name (string): The name of the created text element
id (string): The unique ID of the created text element

Usage Examples

Basic Text

Create simple text with default styling:

await mcp.callTool("create_text", {
  x: 100,
  y: 100,
  text: "Hello, World!"
});

Heading Text

Create a large, bold heading:

await mcp.callTool("create_text", {
  x: 50,
  y: 50,
  text: "Welcome Back",
  fontSize: 32,
  fontWeight: 700,
  name: "Page Heading"
});

Colored Text

Create text with a custom color:

await mcp.callTool("create_text", {
  x: 100,
  y: 200,
  text: "This is a blue link",
  fontSize: 16,
  fontWeight: 500,
  fontColor: {
    r: 0,
    g: 0.5,
    b: 1,
    a: 1
  },
  name: "Link Text"
});

Text Inside a Frame

Create text as a child of an existing frame:

// Create a button frame
const button = await mcp.callTool("create_frame", {
  x: 100,
  y: 300,
  width: 120,
  height: 40,
  name: "Button",
  fillColor: { r: 0.2, g: 0.4, b: 1, a: 1 },
  layoutMode: "HORIZONTAL",
  primaryAxisAlignItems: "CENTER",
  counterAxisAlignItems: "CENTER"
});

// Add text inside the button
await mcp.callTool("create_text", {
  x: 0,
  y: 0,
  text: "Sign In",
  fontSize: 16,
  fontWeight: 600,
  fontColor: { r: 1, g: 1, b: 1, a: 1 },
  name: "Button Label",
  parentId: button.id
});

Form Label

Create a label for an input field:

await mcp.callTool("create_text", {
  x: 20,
  y: 150,
  text: "Email Address",
  fontSize: 14,
  fontWeight: 500,
  fontColor: { r: 0.3, g: 0.3, b: 0.3, a: 1 },
  name: "Email Label"
});

Semi-Transparent Helper Text

Create helper text with reduced opacity:

await mcp.callTool("create_text", {
  x: 20,
  y: 250,
  text: "Forgot your password?",
  fontSize: 12,
  fontWeight: 400,
  fontColor: {
    r: 0.4,
    g: 0.4,
    b: 0.4,
    a: 0.7
  },
  name: "Helper Link"
});

Multi-Element Text Layout

Create a complete text hierarchy:

// Create container frame
const container = await mcp.callTool("create_frame", {
  x: 50,
  y: 50,
  width: 400,
  height: 300,
  name: "Text Container",
  layoutMode: "VERTICAL",
  itemSpacing: 12,
  paddingTop: 24,
  paddingLeft: 24
});

// Title
await mcp.callTool("create_text", {
  x: 0,
  y: 0,
  text: "Article Title",
  fontSize: 28,
  fontWeight: 700,
  parentId: container.id,
  name: "Title"
});

// Subtitle
await mcp.callTool("create_text", {
  x: 0,
  y: 0,
  text: "A brief description of the article",
  fontSize: 16,
  fontWeight: 400,
  fontColor: { r: 0.5, g: 0.5, b: 0.5, a: 1 },
  parentId: container.id,
  name: "Subtitle"
});

// Body text
await mcp.callTool("create_text", {
  x: 0,
  y: 0,
  text: "This is the main body content of the article...",
  fontSize: 14,
  fontWeight: 400,
  parentId: container.id,
  name: "Body"
});

Notes

Text content can be modified later using the set_text_content tool
Font color uses RGBA format with values between 0 and 1 (not 0-255)
The text element auto-sizes to fit the content by default
When placed inside an auto-layout frame, the text will respect the frame’s alignment settings
Position coordinates are relative to the parent container if parentId is specified
Use the returned id to modify the text later with tools like set_text_content or set_fill_color

⌘I

Document & Selection

Creating Elements

Text Operations

Styling

Layout & Organization

Auto Layout

Components & Styles

Annotations

Prototyping & Connections

Export

Connection Management

AI Prompts

Overview

Parameters

Position & Content

Styling Properties

Other Properties

Return Type

Usage Examples

Basic Text

Heading Text

Colored Text

Text Inside a Frame

Form Label

Semi-Transparent Helper Text

Multi-Element Text Layout

Notes

​Overview

​Parameters

​Position & Content

​Styling Properties

​Other Properties

​Return Type

​Usage Examples

​Basic Text

​Heading Text

​Colored Text

​Text Inside a Frame

​Form Label

​Semi-Transparent Helper Text

​Multi-Element Text Layout

​Notes

Overview

Parameters

Position & Content

Styling Properties

Other Properties

Return Type

Usage Examples

Basic Text

Heading Text

Colored Text

Text Inside a Frame

Form Label

Semi-Transparent Helper Text

Multi-Element Text Layout

Notes