Merge Unified's Lucidchart integration Merge Agent Handler's Lucidchart MCP server

Connect your AI Agents to Lucidchart in minutes

Merge lets you securely connect your agents to Lucidchart and thousands of tools instantly

Start building for free

Read docs

Lucidchart

Learn more about Merge Agent Handler

Available tools

get_document_user_collaborator

Get a specific user's collaboration details on a document, including their role.

remove_document_user_collaborator

Remove a user's access to a document. This revokes all their permissions on the document.

list_document_user_collaborators

List all user collaborators on a document with their roles. Supports pagination via cursor.

get_folder_user_collaborator

Get a specific user's collaboration details on a folder, including their role.

remove_folder_user_collaborator

Remove a user's access to a folder. This revokes all their permissions on the folder.

list_folder_user_collaborators

List all user collaborators on a folder with their roles. Supports pagination via cursor.

create_document

Create a new Lucid document. Specify the product type (lucidchart, lucidspark, or lucidscale) and optional parent folder.

get_document

Get a document by its UUID. Returns document metadata including title, URLs, version, page count, and owner info.

get_document_contents

Get the full raw contents of a document including all pages, shapes, lines, groups, and custom data. To just read the text, use getdocumenttext, which is much smaller.

get_document_text

Read a document's text: every shape's text and each line as '<from> -> <to>: label', grouped under page headers. Use this to READ a diagram; getdocumentcontents returns the full raw structure, exportdocument an image. Use searchdocuments to find document IDs. extraction_status 'empty' means no text, do not guess.

search_documents

Search for documents by product type, keywords, creation date, or last modified date. Supports pagination via cursor.

trash_document

Move a document to the trash by its UUID. The document can be restored by an admin.

export_document

Export a document page as a PNG or JPEG image. Returns base64-encoded image data, not text: to READ a document's text, use getdocumenttext. Optionally specify page, crop area, and DPI.

create_folder

Create a new folder in Lucid. Specify the folder name, type (folder or team), and optional parent folder ID.

get_folder

Get a folder by its ID. Returns folder metadata including name, type, parent, and creation date.

update_folder

Update a folder's name or parent. Provide the folder ID and the fields to update.

trash_folder

Move a folder to the trash by its ID. The folder can be restored later.

restore_folder

Restore a folder from trash by its ID.

search_folders

Search for folders by type and keywords. Supports pagination via cursor. Use cursor from page_info for next page.

list_folder_contents

List the contents of a folder (documents, subfolders). Supports pagination via cursor.

list_root_folder_contents

List the contents of the root folder. Returns documents and folders at the top level. Supports pagination.

create_document_share_link

Create a share link for a document. Specify the role (editandshare, edit, comment, view) and optional security settings.

get_document_share_link

Get a specific share link for a document by its link ID.

update_document_share_link

Update a document share link's role or security settings.

delete_document_share_link

Delete a share link from a document, revoking access for anyone who has it.

create_folder_share_link

Create a share link for a folder. Specify the role (editandshare, edit, comment, view) and optional security settings.

get_folder_share_link

Get a specific share link for a folder by its link ID.

update_folder_share_link

Update a folder share link's role or security settings.

delete_folder_share_link

Delete a share link from a folder, revoking access for anyone who has it.

get_current_user

Get the profile of the currently authenticated user, including account ID, username, email, and full name.

validate_credential

Validate Lucidchart API credentials by making a test request to the user profile endpoint.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Lucidchart MCP server

What is a Lucidchart MCP?

It's an MCP server that connects your agents to Lucidchart through tools. Your agents can invoke these tools to create and retrieve diagrams, search documents across a workspace, manage folder contents, and control collaborator access, and more.

Lucid doesn't offer an MCP server purpose built for Lucidchart (they just have an MCP server for Lucid), but you can use one from a third-party platform, like Merge Agent Handler.

How can I use the Lucidchart MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

Architecture diagram creation on new service launch: When a new service is merged into a GitHub repo, an agent creates a Lucidchart document in the appropriate workspace folder with the service name and key dependencies pre-populated, giving engineers a documentation starting point without manual setup

Diagram retrieval during incidents: When an on-call engineer is paged, an agent searches Lucidchart for architecture diagrams matching the affected system and surfaces the most recent document directly in the incident Slack thread, cutting down the time spent hunting for context

Collaborator access auditing: When a contractor or vendor is offboarded, an agent lists all Lucidchart documents they're a collaborator on, then removes their access and posts a summary to a security Slack channel for review

Automated diagram export for design reviews: When a design review meeting is created in Google Calendar, an agent searches Lucidchart for the relevant diagram, exports it as a PDF, and posts the file to the meeting's Slack thread so reviewers have the latest version without opening Lucidchart

What are popular tools for Lucidchart's MCP server?

Here are some of the most commonly used tools:

search_documents: searches across a Lucidchart workspace for documents matching a query string. Call this when an agent needs to locate a specific diagram before retrieving or exporting it

get_document_contents: retrieves the full contents of a Lucidchart document by ID. Useful for agents that need to read diagram structure or metadata before taking a follow-on action

create_document: creates a new Lucidchart document in a specified folder. Good for workflows that need to scaffold documentation automatically when a new project, service, or team is created

export_document: exports a Lucidchart diagram to a shareable format such as PDF or PNG. Use this when an agent needs to attach a diagram to a ticket, email, or calendar event without requiring the recipient to have Lucidchart access

list_document_user_collaborators: returns all users with access to a specific document. Helpful when an agent needs to audit who can view or edit a sensitive architecture diagram

list_folder_contents: lists all documents and subfolders within a given folder. Call this when an agent needs to inventory a workspace section before searching, reorganizing, or reporting on its contents

What makes Merge Agent Handler's Lucidchart MCP server better than alternative Lucidchart MCP servers?

A few things make Merge Agent Handler's Lucidchart MCP server the stronger choice over building or using an alternative:

Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Lucidchart, this means you can prevent proprietary architecture diagrams, internal system names, or confidential org charts from being surfaced to an agent that doesn't need that level of access

Managed authentication and credentials: Merge stores and refreshes your Lucidchart OAuth credentials on your behalf. You never expose access tokens to an agent directly or deal with expired credentials breaking a workflow

Real-time observability and audit trail: Every Lucidchart tool call is logged with the timestamp, tool name, inputs, and response metadata. You can see exactly which documents an agent accessed, exported, or modified without adding any custom logging

Tool Packs and controlled access: Tool Packs let you bundle specific Lucidchart tools with tools from other connectors into a single scoped MCP endpoint. A read-only diagram retrieval agent never gets access to trash_document or collaborator management tools.

How can I start using Merge Agent Handler's Lucidchart MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account.

2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.

3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.

4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose Lucidchart and complete the OAuth flow. Merge stores and manages the credentials going forward.

5.. Open a Claude Code session and start querying Lucidchart data directly. The first time you use a Lucidchart tool, a Magic Link may appear to complete connector authentication.

If you want to connect Merge Agent Handler's Lucidchart MCP with internal or customer-facing agentic products, you can follow the steps in our docs.

Can employees use Merge to connect their AI tools to Lucidchart?

Yes, Merge for Workforce lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to Lucidchart without bypassing IT governance.

Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Merge and gets individual credentials tied to their identity.

IT also provisions access by role or group via SCIM. A software engineer, for example, gets Lucidchart access to create and retrieve architecture diagrams, Confluence to link diagrams to technical docs, and Slack to share updates during incident response; while a business analyst gets Lucidchart access to document process flows, Jira to connect diagrams to project tickets, and Google Drive to export diagrams for stakeholder reviews.

Every tool call an employee's AI makes to Lucidchart is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.