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
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
