figma-use-figjam

Name: figma-use-figjam
Author: figma

1.8kstars163forks

How to install figma-use-figjam?

figma/mcp-server-guide/figma-use-figjam

$npx -y skills add figma/mcp-server-guide --skill figma-use-figjam

Installs into the current project.

Summary

This 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_figma tool.

Files · 1

View on GitHub

SKILL.md

1	# use_figma — Figma Plugin API Skill for FigJam
2
3	This skill contains FigJam-specific context for the `use_figma` MCP tool. The [figma-use](../figma-use/SKILL.md) skill provides foundational context for plugin API execution via MCP as well as the full Figma plugin API for more advanced use-cases that are not described here.
4
5	Always include `figma-use-figjam` in the comma-separated `skillNames` parameter when calling `use_figma` for FigJam operations. If this skill was loaded via an MCP resource, you MUST prefix the name with `resource:` (e.g. `resource:figma-use-figjam`). This is a logging parameter used to track skill usage — it does not affect execution.
6
7	> FigJam URL is `figma.com/board/...`. Do NOT call `figma.createPage()` in FigJam — it throws `TypeError: figma.createPage no such property 'createPage' on the figma global object`. `createPage()` is a Design-file API only (`figma.com/design/...`). FigJam files have a single implicit page; organize content with sections instead (see [create-section](references/create-section.md)).
8
9	## Inspecting FigJam Files
10
11	`get_figjam` is the inspection tool for FigJam files. It returns the full node tree as XML, including IDs of pages, sections, stickies, connectors, and other nodes you need to reference in subsequent `use_figma` calls.
12
13	- Use `get_figjam` upfront before writing any `use_figma` code that needs to reference existing nodes (page IDs, section IDs, etc.). Don't try to discover IDs by running an inspection script — `console.log` output from `use_figma` is not returned to the agent (see [figma-use Critical Rule #4](../figma-use/SKILL.md)). Only the `return` value comes back.
14	- `get_metadata` does NOT work on FigJam files — it is design-mode only and will fail immediately with "unsupported for FigJam files".
15	- `get_screenshot` requires a valid `nodeId` — passing an empty nodeId returns "invalid nodeId" error. Get IDs from `get_figjam` first.
16	- If you forgot to `return` an ID from a previous `use_figma` call and need it now, call `get_figjam` rather than re-running an inspection script.
17
18	## Loading Reference Docs Efficiently
19
20	Load only the references your task needs — but when you do need to load multiple, issue all reads in a single parallel tool-call batch, not sequentially across turns. For a typical board-creation task, that means a single message containing reads for `plan-board-content` plus the 3-4 specific node-type references you'll use.
21
22	## Deferred Tools — Batch-Load Schemas
23
24	The Figma MCP tools (`use_figma`, `get_figjam`, `get_screenshot`, `get_metadata`, `create_new_file`, `whoami`) often appear as deferred tools that require `ToolSearch` to load their schemas before they can be called. Load all schemas in a single `ToolSearch` call using the `select:` syntax instead of one call per tool:
25
26	```
27	ToolSearch query="select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file"
28	```
29
30	Six sequential `ToolSearch` calls is six round trips before any work happens. One batched call is one round trip.
31
32	## Text Mutations — Canonical Recipe
33
34	Every FigJam text mutation (sticky/shape/label/table cell/connector text, standalone text nodes) follows the same recipe as Design files: load font → `await` → mutate → return affected IDs. Skipping the load throws `Cannot write to node with unloaded font "<family> <style>"`. See [figma-use → gotchas.md → Canonical text-edit recipe](../figma-use/references/gotchas.md#canonical-text-edit-recipe-font-load--await--mutate--return-ids). FigJam-specific note: sublayer defaults vary (sticky → `Inter Medium`, shape → `Inter Medium`, connector → invalid until set), so always load from `node.text.fontName` rather than hardcoding `{ family: 'Inter', style: 'Regular' }`.
35
36	## Adding Images to a FigJam Board
37
38	`upload_assets` is the ONLY supported way to add images to a FigJam file. Do NOT use `figma.createImage()` or `figma.createImageAsync()` from inside `use_figma` — they are unsupported as image-upload entry points in FigJam. Call `upload_assets` with the FigJam `fileKey`; the tool returns single-use upload URLs that you POST raw image bytes to, and the image is committed and placed automatically. Pass `nodeId` (with `count: 1`) to attach the upload to an existing FigJam node as a fill; omit `nodeId` to drop the image onto the board as a new layer.
39
40	For the full request/response shape, see [figma-use → api-reference.md → Images](../figma-use/references/api-reference.md#images).
41
42	## Reference Docs
43
44	- [plan-board-content](references/plan-board-content.md) - Read this for any board content request — board template, retro, brainstorm, ice breaker, meeting board, scaffold
45	- Covers planning of generated board content, including sequential outl

figmaPublisher · 15 listings

Preview

figma/mcp-server-guide

# use_figma — Figma Plugin API Skill for FigJam

This skill contains FigJam-specific context for the `use_figma` MCP tool. The [figma-use](../figma-use/SKILL.md) skill provides foundational context for plugin

**Always include `figma-use-figjam` in the comma-separated `skillNames` parameter when calling `use_figma` for FigJam operations. If this skill was loaded via a

> **FigJam URL is `figma.com/board/...`.** Do NOT call `figma.createPage()` in FigJam — it throws `TypeError: figma.createPage no such property 'createPage' on

Repofigma/mcp-server-guide

License—

TypeSkills

CategoryDesign

UpdatedJul 2026

Repo stars1.8k

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

figma-use-figjam

1.8kstars163forks

View on GitHub

How to install figma-use-figjam?

figma/mcp-server-guide/figma-use-figjam

$npx -y skills add figma/mcp-server-guide --skill figma-use-figjam

Installs into the current project.

Summary

This 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_figma tool.

Files · 1

View on GitHub

SKILL.md

1	# use_figma — Figma Plugin API Skill for FigJam
2
3	This skill contains FigJam-specific context for the `use_figma` MCP tool. The [figma-use](../figma-use/SKILL.md) skill provides foundational context for plugin API execution via MCP as well as the full Figma plugin API for more advanced use-cases that are not described here.
4
5	Always include `figma-use-figjam` in the comma-separated `skillNames` parameter when calling `use_figma` for FigJam operations. If this skill was loaded via an MCP resource, you MUST prefix the name with `resource:` (e.g. `resource:figma-use-figjam`). This is a logging parameter used to track skill usage — it does not affect execution.
6
7	> FigJam URL is `figma.com/board/...`. Do NOT call `figma.createPage()` in FigJam — it throws `TypeError: figma.createPage no such property 'createPage' on the figma global object`. `createPage()` is a Design-file API only (`figma.com/design/...`). FigJam files have a single implicit page; organize content with sections instead (see [create-section](references/create-section.md)).
8
9	## Inspecting FigJam Files
10
11	`get_figjam` is the inspection tool for FigJam files. It returns the full node tree as XML, including IDs of pages, sections, stickies, connectors, and other nodes you need to reference in subsequent `use_figma` calls.
12
13	- Use `get_figjam` upfront before writing any `use_figma` code that needs to reference existing nodes (page IDs, section IDs, etc.). Don't try to discover IDs by running an inspection script — `console.log` output from `use_figma` is not returned to the agent (see [figma-use Critical Rule #4](../figma-use/SKILL.md)). Only the `return` value comes back.
14	- `get_metadata` does NOT work on FigJam files — it is design-mode only and will fail immediately with "unsupported for FigJam files".
15	- `get_screenshot` requires a valid `nodeId` — passing an empty nodeId returns "invalid nodeId" error. Get IDs from `get_figjam` first.
16	- If you forgot to `return` an ID from a previous `use_figma` call and need it now, call `get_figjam` rather than re-running an inspection script.
17
18	## Loading Reference Docs Efficiently
19
20	Load only the references your task needs — but when you do need to load multiple, issue all reads in a single parallel tool-call batch, not sequentially across turns. For a typical board-creation task, that means a single message containing reads for `plan-board-content` plus the 3-4 specific node-type references you'll use.
21
22	## Deferred Tools — Batch-Load Schemas
23
24	The Figma MCP tools (`use_figma`, `get_figjam`, `get_screenshot`, `get_metadata`, `create_new_file`, `whoami`) often appear as deferred tools that require `ToolSearch` to load their schemas before they can be called. Load all schemas in a single `ToolSearch` call using the `select:` syntax instead of one call per tool:
25
26	```
27	ToolSearch query="select:use_figma,get_figjam,get_screenshot,get_metadata,create_new_file"
28	```
29
30	Six sequential `ToolSearch` calls is six round trips before any work happens. One batched call is one round trip.
31
32	## Text Mutations — Canonical Recipe
33
34	Every FigJam text mutation (sticky/shape/label/table cell/connector text, standalone text nodes) follows the same recipe as Design files: load font → `await` → mutate → return affected IDs. Skipping the load throws `Cannot write to node with unloaded font "<family> <style>"`. See [figma-use → gotchas.md → Canonical text-edit recipe](../figma-use/references/gotchas.md#canonical-text-edit-recipe-font-load--await--mutate--return-ids). FigJam-specific note: sublayer defaults vary (sticky → `Inter Medium`, shape → `Inter Medium`, connector → invalid until set), so always load from `node.text.fontName` rather than hardcoding `{ family: 'Inter', style: 'Regular' }`.
35
36	## Adding Images to a FigJam Board
37
38	`upload_assets` is the ONLY supported way to add images to a FigJam file. Do NOT use `figma.createImage()` or `figma.createImageAsync()` from inside `use_figma` — they are unsupported as image-upload entry points in FigJam. Call `upload_assets` with the FigJam `fileKey`; the tool returns single-use upload URLs that you POST raw image bytes to, and the image is committed and placed automatically. Pass `nodeId` (with `count: 1`) to attach the upload to an existing FigJam node as a fill; omit `nodeId` to drop the image onto the board as a new layer.
39
40	For the full request/response shape, see [figma-use → api-reference.md → Images](../figma-use/references/api-reference.md#images).
41
42	## Reference Docs
43
44	- [plan-board-content](references/plan-board-content.md) - Read this for any board content request — board template, retro, brainstorm, ice breaker, meeting board, scaffold
45	- Covers planning of generated board content, including sequential outl

figmaPublisher · 15 listings

Preview

figma/mcp-server-guide

# use_figma — Figma Plugin API Skill for FigJam

This skill contains FigJam-specific context for the `use_figma` MCP tool. The [figma-use](../figma-use/SKILL.md) skill provides foundational context for plugin

**Always include `figma-use-figjam` in the comma-separated `skillNames` parameter when calling `use_figma` for FigJam operations. If this skill was loaded via a

> **FigJam URL is `figma.com/board/...`.** Do NOT call `figma.createPage()` in FigJam — it throws `TypeError: figma.createPage no such property 'createPage' on

Repofigma/mcp-server-guide

License—

TypeSkills

CategoryDesign

UpdatedJul 2026

Repo stars1.8k

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type