# How to integrate Figma MCP with Autogen

```json
{
  "title": "How to integrate Figma MCP with Autogen",
  "toolkit": "Figma",
  "toolkit_slug": "figma",
  "framework": "AutoGen",
  "framework_slug": "autogen",
  "url": "https://composio.dev/toolkits/figma/framework/autogen",
  "markdown_url": "https://composio.dev/toolkits/figma/framework/autogen.md",
  "updated_at": "2026-10-04T16:38:32.620Z"
}
```

## Introduction

This guide walks you through connecting Figma to AutoGen using the Composio tool router. By the end, you'll have a working Figma agent that can add a comment to this figma file, convert design tokens to tailwind css, delete a reaction from a comment through natural language commands.
This guide will help you understand how to give your AutoGen agent real control over a Figma account through Composio's Figma MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.

## Also integrate Figma with

- [Claude Code](https://composio.dev/toolkits/figma/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/figma/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/figma/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/figma/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/figma/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/figma/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/figma/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/figma/framework/grok-bot)
- [Muse](https://composio.dev/toolkits/figma/framework/muse)
- [Codex](https://composio.dev/toolkits/figma/framework/codex)
- [Kimi Code](https://composio.dev/toolkits/figma/framework/kimi)
- [Grok Build](https://composio.dev/toolkits/figma/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/figma/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/figma/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/figma/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/figma/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/figma/framework/atomic-agent)
- [CLI](https://composio.dev/toolkits/figma/framework/cli)
- [Google ADK](https://composio.dev/toolkits/figma/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/figma/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/figma/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/figma/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/figma/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/figma/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/figma/framework/pydantic-ai)

## TL;DR

Here's what you'll learn:
- Get and set up your OpenAI and Composio API keys
- Install the required dependencies for Autogen and Composio
- Initialize Composio and create a Tool Router session for Figma
- Wire that MCP URL into Autogen using McpWorkbench and StreamableHttpServerParams
- Configure an Autogen AssistantAgent that can call Figma tools
- Run a live chat loop where you ask the agent to perform Figma operations

## What is AutoGen?

Autogen is a framework for building multi-agent conversational AI systems from Microsoft. It enables you to create agents that can collaborate, use tools, and maintain complex workflows.
Key features include:
- Multi-Agent Systems: Build collaborative agent workflows
- MCP Workbench: Native support for Model Context Protocol tools
- Streaming HTTP: Connect to external services through streamable HTTP
- AssistantAgent: Pre-built agent class for tool-using assistants

## What is the Figma MCP server, and what's possible with it?

The Figma MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Figma account. It provides structured and secure access to your Figma projects, files, components, variables, and prototypes, so your agent can explore designs, inspect file details, extract design tokens, review interactions, and download images on your behalf.
- Project and file discovery: Have your agent list visible team projects, find files within a project, and retrieve file names, creators, modification details, thumbnails, and access information.
- Focused design inspection: Direct your agent to examine a complete design file or selected layers, detect background layers, and return only the design details needed for the task.
- Design token extraction: Let the agent collect styles, variables, and values from your designs, then convert those tokens into a Tailwind CSS configuration.
- Component and library review: Instruct your agent to retrieve published components, component sets, and detailed metadata for a specific component in a Figma library.
- Prototype and asset handoff: Have your agent review prototype interactions and animations, then download images from selected design layers for implementation.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `FIGMA_ADD_A_COMMENT_TO_A_FILE` | Add a comment to a file | Posts a new comment to a Figma file or branch, optionally replying to an existing root comment (replies cannot be nested); `region_height` and `region_width` in `client_meta` must be positive if defining a comment region. |
| `FIGMA_ADD_A_REACTION_TO_A_COMMENT` | Add a reaction to a comment | Posts a specified emoji reaction to an existing comment in a Figma file or branch, requiring valid file_key and comment_id. |
| `FIGMA_CREATE_A_WEBHOOK` | Create a webhook | Creates a Figma webhook to receive POST notifications when specific events occur. Webhooks can monitor events at three scopes: - Team level: monitors all files in a team (requires team admin permissions) - Project level: monitors all files in a project (requires edit access) - File level: monitors a specific file (requires edit access) Upon creation, Figma sends an initial PING event to verify your endpoint (unless status is PAUSED). IMPORTANT: team_id, project_id, and file_key cannot be discovered programmatically. Extract them from Figma URLs or use FIGMA_DISCOVER_FIGMA_RESOURCES to parse URLs. |
| `FIGMA_CREATE_DEV_RESOURCES` | Create dev resources | Creates and attaches multiple uniquely-URLed development resources to specified Figma nodes, up to 10 per node. |
| `FIGMA_CREATE_MODIFY_DELETE_VARIABLES` | Create, modify, or delete variables | Manages variables, collections, modes, and their values in a Figma file via batch create/update/delete operations; use temporary IDs to link new related items in one request and ensure `variableModeValues` match the target variable's `resolvedType`. |
| `FIGMA_DELETE_A_COMMENT` | Delete a comment | Deletes a specific comment from a Figma file or branch, provided the authenticated user is the original author of the comment. |
| `FIGMA_DELETE_A_REACTION` | Delete a reaction | Deletes a specific emoji reaction from a comment in a Figma file; the user must have originally created the reaction. |
| `FIGMA_DELETE_A_WEBHOOK` | Delete a webhook | Permanently deletes an existing webhook, identified by its unique `webhook_id`; this operation is irreversible. |
| `FIGMA_DELETE_DEV_RESOURCE` | Delete dev resource | Deletes a development resource (used to link Figma design elements to external developer information like code or tasks) from a specified Figma file. |
| `FIGMA_DESIGN_TOKENS_TO_TAILWIND` | Design tokens to tailwind | Convert design tokens to Tailwind CSS configuration. TWO-STEP WORKFLOW: 1. First, call FIGMA_EXTRACT_DESIGN_TOKENS with a Figma file_key to extract design tokens 2. Then, pass the returned DesignTokens object to this action's 'tokens' parameter This action generates: - tailwind.config.ts/js with theme extensions - Optional globals.css with font imports Note: Shadow colors can be provided in either string format (e.g., "rgba(15, 110, 110, 0.32)") or dictionary format (e.g., {"r": 0.059, "g": 0.431, "b": 0.431, "a": 0.32}). |
| `FIGMA_DETECT_BACKGROUND` | Detect Background Layers | Detect background layers for selected nodes in a Figma file. This action analyzes the Figma document structure and identifies potential background elements for the given target nodes. It uses: - Geometric analysis (bounding box overlap/containment) - Z-index ordering (nodes earlier in the layer stack are behind later ones) - Visual properties (fills, node types) - Naming conventions (nodes named 'background', 'bg', etc.) Returns background candidates with confidence scores (0-1) and explanations. |
| `FIGMA_DISCOVER_FIGMA_RESOURCES` | Discover Figma Resources | Smart Figma resource discovery - extract IDs from any Figma URL. Supports all URL formats: /file/, /design/, /board/, /proto/, /slides/ Example: figma.com/board/ABC123/Name → file_key=ABC123 Discovery workflow: team_id → projects → files → nodes Use extracted IDs with GetFileJson, DetectBackground, etc. |
| `FIGMA_DOWNLOAD_FIGMA_IMAGES` | Download Figma Images | Download images from Figma file nodes. Renders specified nodes as images and downloads them. Supports PNG, SVG, JPG, and PDF formats. REQUIRED PARAMETERS: - file_key (string): The Figma file key from the URL - images (array): List of objects, each containing: - node_id (string, required): The node ID to export (e.g., "1:2") - file_name (string, required): Output filename with extension (e.g., "logo.png") - format (string, optional): One of 'png', 'svg', 'jpg', 'pdf'. Defaults to 'png' Example usage: { "file_key": "abc123XYZ", "images": [ {"node_id": "1:2", "file_name": "logo.png", "format": "png"} ] } To find node IDs, use FIGMA_GET_FILE_JSON or look in Figma URLs after 'node-id='. NOTE: Returned image URLs expire shortly after generation — download them immediately. |
| `FIGMA_EXTRACT_DESIGN_TOKENS` | Extract design tokens | Extract design tokens from Figma files by combining styles, variables, and node-extracted values. Only values defined as Figma styles or variables are captured — any design values not encoded as styles/variables are silently omitted. Requires `file_variables:read` scope and a Figma plan that supports variables for full output; if variables return empty, supplement with FIGMA_GET_LOCAL_VARIABLES. |
| `FIGMA_EXTRACT_PROTOTYPE_INTERACTIONS` | Extract Prototype Interactions | Extract prototype interactions and animations from Figma files. Required parameter: - file_key: The Figma file key extracted from a URL like 'https://www.figma.com/file/ABC123xyz/MyFile' (the 'ABC123xyz' part) Analyzes the prototype data to extract: - User interactions (clicks, hovers, etc.) - Transition animations - Component variant states - User flows and navigation |
| `FIGMA_GET_ACTIVITY_LOGS` | Get activity logs | Retrieves activity log events from Figma, allowing filtering by event types, time range, and pagination. |
| `FIGMA_GET_A_WEBHOOK` | Get a webhook | Retrieves detailed information about a specific webhook by its ID, provided the webhook exists and is accessible to the user. |
| `FIGMA_GET_COMMENTS_IN_A_FILE` | Get comments in a file | Retrieves all comments from an existing Figma file, identified by a valid `file_key`, returning details like content, author, position, and reactions, with an option for Markdown formatted content. |
| `FIGMA_GET_COMPONENT2` | Get component | Fetches metadata for a specific component using its unique identifier. Use when you need to retrieve published component details from a team library. |
| `FIGMA_GET_COMPONENT_SET` | Get component set | Retrieves detailed metadata for a specific published Figma component set using its unique `key`. |
| `FIGMA_GET_CURRENT_USER` | Get current user | Retrieves detailed information for the currently authenticated Figma user. |
| `FIGMA_GET_DEV_RESOURCES` | Get dev resources | Retrieves development resources (e.g., Jira/GitHub links) for a Figma main file, optionally filtering by specific node IDs. |
| `FIGMA_GET_FILE_COMPONENTS` | Get file components | Retrieves published components from a Figma file, which must be a main file (not a branch) acting as a library. |
| `FIGMA_GET_FILE_COMPONENT_SETS` | Get file component sets | Retrieves all published component sets from the specified Figma main file (file_key must not be for a branch). |
| `FIGMA_GET_FILE_JSON` | Get file json | Get Figma Design file data with automatic simplification. IMPORTANT: Only supports Design files (figma.com/design/{file_key}). FigJam board files (figma.com/board/{file_key}) and Slides files (figma.com/slides/{file_key}) are NOT supported and will return a 400 error: "File type not supported by this endpoint". This enhanced version automatically transforms verbose Figma JSON into clean, AI-friendly format with: - CSS-like property names - Deduplicated variables - Removed empty values - 70%+ size reduction Use simplify=False to get raw API response. |
| `FIGMA_GET_FILE_METADATA` | Get file metadata | Get Figma file metadata including name, creator, last modification details, thumbnail, and access information. Use when you need quick file overview without the full document tree. |
| `FIGMA_GET_FILE_NODES` | Get file nodes | Fetch JSON for specific node IDs from a Figma file to avoid full-file payload limits. Use when you already know target node IDs (from shallow file fetch or component listings) or when full-file JSON has hit payload limits. Prefer depth=1 for fast discovery. |
| `FIGMA_GET_FILES_IN_A_PROJECT` | Get files in a project | Fetches a list of files in a Figma project, optionally including branch metadata. |
| `FIGMA_GET_FILE_STYLES` | Get file styles | Retrieves a list of published styles (like colors, text attributes, effects, and layout grids) from a specified main Figma file (not a branch). |
| `FIGMA_GET_IMAGE_FILLS` | Get image fills | Retrieves temporary (14-day expiry) download URLs for all image fills in a Figma file; requires `imageRef` from `Paint` objects to map URLs. |
| `FIGMA_GET_LIBRARY_ANALYTICS_COMPONENT_ACTION_DATA` | Get library analytics component action data | Retrieves component insertion and detachment analytics for a specified Figma library, groupable by 'component' or 'team' and filterable by a date range (YYYY-MM-DD). |
| `FIGMA_GET_LIBRARY_ANALYTICS_COMPONENT_USAGE_DATA` | Get library analytics component usage data | Retrieves component usage analytics for a specified Figma library file (identified by `file_key`), with data groupable by 'component' or 'file'. |
| `FIGMA_GET_LIBRARY_ANALYTICS_STYLE_ACTION_DATA` | Get library analytics style action data | Retrieves style usage analytics (insertions, detachments) for a Figma library, grouped by 'style' or 'team'; if providing a date range, ensure end_date is not before start_date. |
| `FIGMA_GET_LIBRARY_ANALYTICS_STYLE_USAGE_DATA` | Get library analytics style usage data | Retrieves style usage analytics for a published Figma library. Returns data about how styles (colors, text styles, effects, grids) from the library are being used across your organization. Requires Enterprise plan and library_analytics:read scope. Group results by 'style' to see per-style metrics or by 'file' to see which files use the library's styles. |
| `FIGMA_GET_LIBRARY_ANALYTICS_VARIABLE_ACTION_DATA` | Get library analytics variable action data | Retrieves weekly, paginated analytics data on variable insertions and detachments for a specified Figma library (identified by `file_key`), groupable by 'variable' or 'team', and filterable by an optional date range. Note: Requires Enterprise plan and library_analytics:read scope. |
| `FIGMA_GET_LIBRARY_ANALYTICS_VARIABLE_USAGE_DATA` | Get library analytics variable usage data | Retrieves paginated analytics data on variable usage from a specified Figma library, grouped by 'file' or 'variable', for libraries with enabled analytics. |
| `FIGMA_GET_LOCAL_VARIABLES` | Get local variables | Retrieves all local/remote variables for a Figma file/branch; crucial for obtaining mode-specific values which `/v1/files/{file_key}/variables/published` omits. |
| `FIGMA_GET_PAYMENTS` | Get payments | Retrieves a user's payment information for a Figma plugin, widget, or Community file; the authenticated identity must own the resource. |
| `FIGMA_GET_PROJECTS_IN_A_TEAM` | Get projects in a team | Retrieves projects within a specified Figma team that are visible to the authenticated user. |
| `FIGMA_GET_PUBLISHED_VARIABLES` | Get published variables | Retrieves variables published from a specified Figma file; this API is available only to full members of Enterprise organizations. |
| `FIGMA_GET_REACTIONS_FOR_A_COMMENT` | Get reactions for a comment | Retrieves reactions for a specific comment in a Figma file. |
| `FIGMA_GET_SCIM_SERVICE_PROVIDER_CONFIG` | Get SCIM service provider config | Get Figma's SCIM service provider configuration. Returns configuration details including which SCIM operations are supported (patch, bulk, filter, etc.), authentication schemes, and service capabilities. |
| `FIGMA_GET_STYLE` | Get style | Retrieves detailed metadata for a specific style in Figma using its unique style key. |
| `FIGMA_GET_TEAM_COMPONENTS` | Get team components | Retrieves components published in a specific Figma team's library; the team must have published components, otherwise an empty list is returned. |
| `FIGMA_GET_TEAM_COMPONENT_SETS` | Get team component sets | Retrieves a paginated list of published component sets (collections of reusable UI elements) from a specified Figma team's library. |
| `FIGMA_GET_TEAM_STYLES` | Get team styles | Retrieves a paginated list of published styles (fill colors, text styles, effects, grids) from a specified Figma team's library. Note: The team must have published styles in its library for this endpoint to return data. Teams without published styles will return an empty list. |
| `FIGMA_GET_TEAM_WEBHOOKS` | Get webhooks | Retrieves all webhooks registered for a specified Figma context (team, project, or file). Uses the Figma Webhooks V2 API endpoint (GET /v2/webhooks) with context and context_id query parameters. This is the recommended approach as the legacy path-based endpoint (/v2/teams/{team_id}/webhooks) is deprecated. Note: team_id, project_id, and file_key cannot be discovered programmatically via the API. Extract them from Figma URLs or use FIGMA_DISCOVER_FIGMA_RESOURCES to parse URLs. |
| `FIGMA_GET_VERSIONS_OF_A_FILE` | Get versions of a file | Retrieves the version history for a Figma file or branch, as specified by its `file_key`. |
| `FIGMA_GET_WEBHOOK_REQUESTS` | Get webhook requests | Retrieves a history of webhook requests for a specific Figma webhook subscription; data is available for requests sent within the last seven days. |
| `FIGMA_RENDER_IMAGES_OF_FILE_NODES` | Render images of file nodes | Render Figma nodes as images (PNG, JPG, SVG, PDF). Returns a map of node IDs to temporary image URLs (valid for 30 days). Images are capped at 32 megapixels; larger requests are automatically scaled down. REQUIRED PARAMETERS: - file_key: Figma file key from URL (e.g., 'abc123XYZ' from figma.com/design/abc123XYZ/...) - ids: Comma-separated node IDs to render (e.g., '1:2' or '1:2,1:3,1:4') NODE IDs: Found in Figma URLs after 'node-id=' or from FIGMA_GET_FILE_JSON response. FORMATS: - png/jpg: Raster images with optional scale (0.01-4.0) - svg: Vector graphics with text outline options - pdf: Document format COMMON ISSUES: - null value in images map = node failed to render (invalid ID, invisible, 0% opacity) - 404 error = file_key not found or no access - 429 error = rate limit exceeded, wait and retry |
| `FIGMA_UPDATE_A_WEBHOOK` | Update a webhook | Updates an existing Figma webhook, identified by `webhook_id`, allowing modification of its event type, endpoint, passcode, status, or description. |
| `FIGMA_UPDATE_DEV_RESOURCES` | Update dev resources | Updates the name and/or URL of one or more existing Figma Dev Resources, each identified by its unique `id`. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Figma MCP server is an implementation of the Model Context Protocol that connects your AI agents and assistants directly to Figma. Instead of manually wiring Figma APIs, OAuth, and scopes yourself, you get a structured, tool-based interface that an LLM can call safely.
With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster.

## Step-by-step Guide

### 1. Prerequisites

You will need:
- A Composio API key
- An OpenAI API key (used by Autogen's OpenAIChatCompletionClient)
- A Figma account you can connect to Composio
- Some basic familiarity with Autogen and Python async

### 1. Getting API Keys for OpenAI and Composio

OpenAI API Key
- Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) and create an API key. You'll need credits to use the models, or you can connect to another model provider.
- Keep the API key safe.
Composio API Key
- Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs).
- Navigate to your API settings and generate a new API key.
- Store this key securely as you'll need it for authentication.

### 2. Install dependencies

Install Composio, Autogen extensions, and dotenv.
What's happening:
- composio connects your agent to Figma via MCP
- autogen-agentchat provides the AssistantAgent class
- autogen-ext-openai provides the OpenAI model client
- autogen-ext-tools provides MCP workbench support
```bash
pip install composio python-dotenv
pip install autogen-agentchat autogen-ext-openai autogen-ext-tools
```

### 3. Set up environment variables

Create a .env file in your project folder.
What's happening:
- COMPOSIO_API_KEY is required to talk to Composio
- OPENAI_API_KEY is used by Autogen's OpenAI client
- USER_ID is how Composio identifies which user's Figma connections to use
```bash
COMPOSIO_API_KEY=your-composio-api-key
OPENAI_API_KEY=your-openai-api-key
USER_ID=your-user-identifier@example.com
```

### 4. Import dependencies and create Tool Router session

What's happening:
- load_dotenv() reads your .env file
- Composio(api_key=...) initializes the SDK
- create(...) creates a Tool Router session that exposes Figma tools
- session.mcp.url is the MCP endpoint that Autogen will connect to
```python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio

from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_ext.tools.mcp import McpWorkbench, StreamableHttpServerParams

load_dotenv()

async def main():
    # Initialize Composio and create a Figma session
    composio = Composio(api_key=os.getenv("COMPOSIO_API_KEY"))
    session = composio.create(
        user_id=os.getenv("USER_ID"),
        toolkits=["figma"]
    )
    url = session.mcp.url
```

### 5. Configure MCP parameters for Autogen

Autogen expects parameters describing how to talk to the MCP server. That is what StreamableHttpServerParams is for.
What's happening:
- url points to the Tool Router MCP endpoint from Composio
- timeout is the HTTP timeout for requests
- sse_read_timeout controls how long to wait when streaming responses
- terminate_on_close=True cleans up the MCP server process when the workbench is closed
```python
# Configure MCP server parameters for Streamable HTTP
server_params = StreamableHttpServerParams(
    url=url,
    timeout=30.0,
    sse_read_timeout=300.0,
    terminate_on_close=True,
    headers={"x-api-key": os.getenv("COMPOSIO_API_KEY")}
)
```

### 6. Create the model client and agent

What's happening:
- OpenAIChatCompletionClient wraps the OpenAI model for Autogen
- McpWorkbench connects the agent to the MCP tools
- AssistantAgent is configured with the Figma tools from the workbench
```python
# Create model client
model_client = OpenAIChatCompletionClient(
    model="gpt-5",
    api_key=os.getenv("OPENAI_API_KEY")
)

# Use McpWorkbench as context manager
async with McpWorkbench(server_params) as workbench:
    # Create Figma assistant agent with MCP tools
    agent = AssistantAgent(
        name="figma_assistant",
        description="An AI assistant that helps with Figma operations.",
        model_client=model_client,
        workbench=workbench,
        model_client_stream=True,
        max_tool_iterations=10
    )
```

### 7. Run the interactive chat loop

What's happening:
- The script prompts you in a loop with You:
- Autogen passes your input to the model, which decides which Figma tools to call via MCP
- agent.run_stream(...) yields streaming messages as the agent thinks and calls tools
- Typing exit, quit, or bye ends the loop
```python
print("Chat started! Type 'exit' or 'quit' to end the conversation.\n")
print("Ask any Figma related question or task to the agent.\n")

# Conversation loop
while True:
    user_input = input("You: ").strip()

    if user_input.lower() in ["exit", "quit", "bye"]:
        print("\nGoodbye!")
        break

    if not user_input:
        continue

    print("\nAgent is thinking...\n")

    # Run the agent with streaming
    try:
        response_text = ""
        async for message in agent.run_stream(task=user_input):
            if hasattr(message, "content") and message.content:
                response_text = message.content

        # Print the final response
        if response_text:
            print(f"Agent: {response_text}\n")
        else:
            print("Agent: I encountered an issue processing your request.\n")

    except Exception as e:
        print(f"Agent: Sorry, I encountered an error: {str(e)}\n")
```

## Complete Code

```python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio

from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_ext.tools.mcp import McpWorkbench, StreamableHttpServerParams

load_dotenv()

async def main():
    # Initialize Composio and create a Figma session
    composio = Composio(api_key=os.getenv("COMPOSIO_API_KEY"))
    session = composio.create(
        user_id=os.getenv("USER_ID"),
        toolkits=["figma"]
    )
    url = session.mcp.url

    # Configure MCP server parameters for Streamable HTTP
    server_params = StreamableHttpServerParams(
        url=url,
        timeout=30.0,
        sse_read_timeout=300.0,
        terminate_on_close=True,
        headers={"x-api-key": os.getenv("COMPOSIO_API_KEY")}
    )

    # Create model client
    model_client = OpenAIChatCompletionClient(
        model="gpt-5",
        api_key=os.getenv("OPENAI_API_KEY")
    )

    # Use McpWorkbench as context manager
    async with McpWorkbench(server_params) as workbench:
        # Create Figma assistant agent with MCP tools
        agent = AssistantAgent(
            name="figma_assistant",
            description="An AI assistant that helps with Figma operations.",
            model_client=model_client,
            workbench=workbench,
            model_client_stream=True,
            max_tool_iterations=10
        )

        print("Chat started! Type 'exit' or 'quit' to end the conversation.\n")
        print("Ask any Figma related question or task to the agent.\n")

        # Conversation loop
        while True:
            user_input = input("You: ").strip()

            if user_input.lower() in ['exit', 'quit', 'bye']:
                print("\nGoodbye!")
                break

            if not user_input:
                continue

            print("\nAgent is thinking...\n")

            # Run the agent with streaming
            try:
                response_text = ""
                async for message in agent.run_stream(task=user_input):
                    if hasattr(message, 'content') and message.content:
                        response_text = message.content

                # Print the final response
                if response_text:
                    print(f"Agent: {response_text}\n")
                else:
                    print("Agent: I encountered an issue processing your request.\n")

            except Exception as e:
                print(f"Agent: Sorry, I encountered an error: {str(e)}\n")

if __name__ == "__main__":
    asyncio.run(main())
```

## Conclusion

You now have an Autogen assistant wired into Figma through Composio's Tool Router and MCP. From here you can:
- Add more toolkits to the toolkits list, for example notion or hubspot
- Refine the agent description to point it at specific workflows
- Wrap this script behind a UI, Slack bot, or internal tool
Once the pattern is clear for Figma, you can reuse the same structure for other MCP-enabled apps with minimal code changes.

## How to build Figma MCP Agent with another framework

- [Claude Code](https://composio.dev/toolkits/figma/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/figma/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/figma/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/figma/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/figma/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/figma/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/figma/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/figma/framework/grok-bot)
- [Muse](https://composio.dev/toolkits/figma/framework/muse)
- [Codex](https://composio.dev/toolkits/figma/framework/codex)
- [Kimi Code](https://composio.dev/toolkits/figma/framework/kimi)
- [Grok Build](https://composio.dev/toolkits/figma/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/figma/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/figma/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/figma/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/figma/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/figma/framework/atomic-agent)
- [CLI](https://composio.dev/toolkits/figma/framework/cli)
- [Google ADK](https://composio.dev/toolkits/figma/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/figma/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/figma/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/figma/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/figma/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/figma/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/figma/framework/pydantic-ai)

## Related Toolkits

- [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams.
- [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content.
- [Are.na](https://composio.dev/toolkits/arena) - Are.na is a creative research platform for collecting images, links, notes, and ideas in channels. Use it to organize inspiration, build knowledge maps, and connect research across projects.
- [Bannerbear](https://composio.dev/toolkits/bannerbear) - Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates.
- [Bannerbite](https://composio.dev/toolkits/bannerbite) - Bannerbite is a creative automation platform for generating images and videos from reusable projects and templates. It helps teams produce on-brand visual assets faster without rebuilding designs from scratch.
- [BeatAPI](https://composio.dev/toolkits/beatapi) - BeatAPI is an asynchronous API platform for AI image, video, and music workflows. It enables scalable generation, video analysis, uploads, and ecommerce video pipelines.
- [Builder.io](https://composio.dev/toolkits/builder_io) - Builder.io is a visual development platform for managing content, models, assets, and Space configuration. Use it to ship editable digital experiences faster without waiting on every code change.
- [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements.
- [Canva MCP](https://composio.dev/toolkits/canva_mcp) - Canva MCP is Canva's remote MCP server for accessing designs and content. It centralizes design assets and enables programmatic design workflows.
- [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools.
- [Cloudinary](https://composio.dev/toolkits/cloudinary) - Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally.
- [Contentdrips](https://composio.dev/toolkits/contentdrips) - Contentdrips is an asynchronous rendering API for branded graphics and carousels. It turns reusable templates into on-brand social visuals at scale.
- [Creatomate](https://composio.dev/toolkits/creatomate) - Creatomate is an API for generating automated videos, images, GIFs, and reusable media templates. Use it to turn structured data into polished visual content at scale.
- [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily.
- [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks.
- [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast.
- [Dribbble](https://composio.dev/toolkits/dribbble) - Dribbble is a design community and publishing platform for managing shots, projects, and attachments. Use it to showcase work, collect feedback, and organize creative designs.
- [Dynamic Mockups](https://composio.dev/toolkits/dynamic_mockups) - Dynamic Mockups is an API platform for generating product mockups, rendering templates, and managing visual asset catalogs. Use it to automate high-quality product visuals, AI images, and motion assets at scale.
- [Dynapictures](https://composio.dev/toolkits/dynapictures) - Dynapictures is a cloud-based platform for generating personalized images at scale. Instantly create hundreds of custom visuals using your data sources, like Google Sheets.
- [Eraser MCP](https://composio.dev/toolkits/eraser_mcp) - Eraser MCP is a workspace for creating and managing technical diagrams and structured documents. It helps teams organize, version, and export diagrams with collaboration-focused tooling.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Figma MCP?

With a standalone Figma MCP server, the agents and LLMs can only access a fixed set of Figma tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Figma and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Autogen?

Yes, you can. Autogen fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Figma tools.

### Can I manage the permissions and scopes for Figma while using Tool Router?

Yes, absolutely. You can configure which Figma scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Figma data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)