Connect your AI Agents to Lucidchart in minutes

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 contents of a document including all pages, shapes, lines, and groups. Useful for reading diagram content.
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. 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.

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}
11Open 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}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 }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}FAQs on using Merge's Lucidchart MCP server
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_documentor 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 Agent Handler to connect their AI tools to Lucidchart?
Yes, Agent Handler for Employees 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 Agent Handler 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.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now





















