Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Connect AI agents to the Lucid MCP server

Vendor MCP35 toolsOAuth 2.1/DCRDesignProductivityCollaboration

The Lucid MCP connector routes your AI agent's tool calls to Lucid's own MCP server through Scalekit. Each user signs in to Lucid once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 35 tools.

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node dotenv

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'lucidmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Lucid MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'lucidmcp_get_mcp_resource',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Comment post document thread — Post a new comment to an existing collaboration thread on a Lucid document
  • Update lucid — Rename a Lucid folder or move it to a different parent
  • Feedback lucid submit — Submit user feedback, a bug report, or a feature request about the Lucid MCP server to Lucid’s product team
  • Library lucid shape — Discover shapes/blocks available to insert into a Lucid document, by library, group, or search term
  • Details lucid shape — Get default size, colors, and text-area/advanced properties for one or more Lucid shape classes
  • Search lucid — Locate regions of a Lucid document that contain specific text, returning page/region indexes you can pass to lucidmcp_fetch

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

lucidmcp__lucid_create_embed#Create an embed for a Lucid document. Internal tool for MCP Apps extension only.1 param

Create an embed for a Lucid document. Internal tool for MCP Apps extension only.

NameTypeRequiredDescription
document_idstringrequiredNo description.
lucidmcp__lucid_create_embed_session_token#Create a session token for an existing Lucid embed. Internal tool for MCP Apps extension only.3 params

Create a session token for an existing Lucid embed. Internal tool for MCP Apps extension only.

NameTypeRequiredDescription
embed_idstringrequiredNo description.
originstringrequiredNo description.
page_idstringoptionalNo description.
lucidmcp_fetch#Retrieve the structured content of a Lucid document by ID, including pages, blocks, and lines.4 params

Retrieve the structured content of a Lucid document by ID, including pages, blocks, and lines.

NameTypeRequiredDescription
idstringrequiredNo description.
metadata_onlystringoptionalNo description.
page_indexstringoptionalNo description.
region_indexstringoptionalNo description.
lucidmcp_get_mcp_resource#Read a resource from the Lucid MCP server by its URI.1 param

Read a resource from the Lucid MCP server by its URI.

NameTypeRequiredDescription
resource_uristringoptionalNo description.
lucidmcp_list_document_thread_comments#List comments on a specific collaboration thread of a Lucid document.2 params

List comments on a specific collaboration thread of a Lucid document.

NameTypeRequiredDescription
document_idstringrequiredNo description.
thread_idstringrequiredNo description.
lucidmcp_list_document_threads#List collaboration threads on a Lucid document.1 param

List collaboration threads on a Lucid document.

NameTypeRequiredDescription
document_idstringrequiredNo description.
lucidmcp_lucid_add_block#Add a new shape or block to a Lucid document with optional position, size, text, and style properties.29 params

Add a new shape or block to a Lucid document with optional position, size, text, and style properties.

NameTypeRequiredDescription
block_typestringrequiredNo description.
document_idstringrequiredNo description.
auto_font_sizestringoptionalNo description.
boldstringoptionalNo description.
container_idstringoptionalNo description.
fill_colorstringoptionalNo description.
font_familystringoptionalNo description.
font_sizestringoptionalNo description.
heightstringoptionalNo description.
highlight_colorstringoptionalNo description.
italicstringoptionalNo description.
line_colorstringoptionalNo description.
line_widthstringoptionalNo description.
linkstringoptionalNo description.
page_idstringoptionalNo description.
rotationstringoptionalNo description.
strikestringoptionalNo description.
stroke_stylestringoptionalNo description.
subscriptstringoptionalNo description.
superscriptstringoptionalNo description.
textstringoptionalNo description.
text_alignstringoptionalNo description.
text_areasstringoptionalNo description.
text_colorstringoptionalNo description.
text_v_alignstringoptionalNo description.
underlinestringoptionalNo description.
widthstringoptionalNo description.
xnumberoptionalNo description.
ynumberoptionalNo description.
lucidmcp_lucid_add_dynamic_table#Add an empty dynamic table (grid/matrix/kanban-style) to a Lucid document.6 params

Add an empty dynamic table (grid/matrix/kanban-style) to a Lucid document.

NameTypeRequiredDescription
document_idstringrequiredNo description.
columnsstringoptionalNo description.
page_idstringoptionalNo description.
rowsstringoptionalNo description.
xnumberoptionalNo description.
ynumberoptionalNo description.
lucidmcp_lucid_add_items_to_dynamic_table#Add existing canvas blocks to a dynamic table; the table groups them into rows/columns based on each block's pivot field.3 params

Add existing canvas blocks to a dynamic table; the table groups them into rows/columns based on each block's pivot field.

NameTypeRequiredDescription
block_idsarrayrequiredNo description.
document_idstringrequiredNo description.
generator_idstringrequiredNo description.
lucidmcp_lucid_add_line#Add a new line or connector to a Lucid document, optionally linking two shapes.31 params

Add a new line or connector to a Lucid document, optionally linking two shapes.

NameTypeRequiredDescription
document_idstringrequiredNo description.
boldstringoptionalNo description.
endpoint1_auto_linkstringoptionalNo description.
endpoint1_position_xstringoptionalNo description.
endpoint1_position_ystringoptionalNo description.
endpoint1_shape_idstringoptionalNo description.
endpoint1_stylestringoptionalNo description.
endpoint1_xstringoptionalNo description.
endpoint1_ystringoptionalNo description.
endpoint2_auto_linkstringoptionalNo description.
endpoint2_position_xstringoptionalNo description.
endpoint2_position_ystringoptionalNo description.
endpoint2_shape_idstringoptionalNo description.
endpoint2_stylestringoptionalNo description.
endpoint2_xstringoptionalNo description.
endpoint2_ystringoptionalNo description.
font_familystringoptionalNo description.
font_sizestringoptionalNo description.
highlight_colorstringoptionalNo description.
italicstringoptionalNo description.
line_colorstringoptionalNo description.
line_shapestringoptionalNo description.
line_widthstringoptionalNo description.
page_idstringoptionalNo description.
strikestringoptionalNo description.
stroke_stylestringoptionalNo description.
subscriptstringoptionalNo description.
superscriptstringoptionalNo description.
textstringoptionalNo description.
text_colorstringoptionalNo description.
underlinestringoptionalNo description.
lucidmcp_lucid_create_diagram_from_specification#Create a Lucid document from a Standard Import JSON specification (.lucid file format).4 params

Create a Lucid document from a Standard Import JSON specification (.lucid file format).

NameTypeRequiredDescription
productstringrequiredNo description.
standard_import_jsonstringrequiredNo description.
titlestringrequiredNo description.
use_assisted_layoutbooleanoptionalNo description.
lucidmcp_lucid_create_erd#Create a Lucid document containing a data-backed Entity Relationship Diagram (ERD) from structured entity and relationship definitions.4 params

Create a Lucid document containing a data-backed Entity Relationship Diagram (ERD) from structured entity and relationship definitions.

NameTypeRequiredDescription
entitiesarrayrequiredNo description.
relationshipsarrayrequiredNo description.
titlestringrequiredNo description.
productstringoptionalNo description.
lucidmcp_lucid_create_folder#Create a new folder in the user's Lucid account.3 params

Create a new folder in the user's Lucid account.

NameTypeRequiredDescription
namestringrequiredNo description.
folder_typestringoptionalNo description.
parentstringoptionalNo description.
lucidmcp_lucid_create_mind_map#Create a Lucid document containing a mind map from structured node data.3 params

Create a Lucid document containing a mind map from structured node data.

NameTypeRequiredDescription
nodesarrayrequiredNo description.
titlestringrequiredNo description.
productstringoptionalNo description.
lucidmcp_lucid_create_org_chart#Create a Lucidchart document containing an org chart from a list of nodes with parent relationships.2 params

Create a Lucidchart document containing an org chart from a list of nodes with parent relationships.

NameTypeRequiredDescription
nodesarrayrequiredNo description.
titlestringrequiredNo description.
lucidmcp_lucid_create_sequence_diagram#Create a Lucid document containing a UML sequence diagram from PlantUML markup.3 params

Create a Lucid document containing a UML sequence diagram from PlantUML markup.

NameTypeRequiredDescription
markupstringrequiredNo description.
productstringrequiredNo description.
titlestringrequiredNo description.
lucidmcp_lucid_delete_items#Delete one or more blocks or lines from a Lucid document by item ID.2 params

Delete one or more blocks or lines from a Lucid document by item ID.

NameTypeRequiredDescription
document_idstringrequiredNo description.
item_idsarrayrequiredNo description.
lucidmcp_lucid_edit_dynamic_table_metadata#Edit the reactive settings of an existing dynamic table: capacity-planning/load-tracking toggles and row/column group-by fields.6 params

Edit the reactive settings of an existing dynamic table: capacity-planning/load-tracking toggles and row/column group-by fields.

NameTypeRequiredDescription
document_idstringrequiredNo description.
generator_idstringrequiredNo description.
column_group_by_fieldstringoptionalNo description.
enable_agile_capacity_planningstringoptionalNo description.
row_group_by_fieldstringoptionalNo description.
show_load_tracking_graphicstringoptionalNo description.
lucidmcp_lucid_edit_item#Edit an existing block or line in a Lucid document — update position, size, text, or style.42 params

Edit an existing block or line in a Lucid document — update position, size, text, or style.

NameTypeRequiredDescription
document_idstringrequiredNo description.
item_idstringrequiredNo description.
auto_font_sizestringoptionalNo description.
boldstringoptionalNo description.
clear_linkbooleanoptionalNo description.
endpoint1_position_xstringoptionalNo description.
endpoint1_position_ystringoptionalNo description.
endpoint1_shape_idstringoptionalNo description.
endpoint1_stylestringoptionalNo description.
endpoint1_xstringoptionalNo description.
endpoint1_ystringoptionalNo description.
endpoint2_position_xstringoptionalNo description.
endpoint2_position_ystringoptionalNo description.
endpoint2_shape_idstringoptionalNo description.
endpoint2_stylestringoptionalNo description.
endpoint2_xstringoptionalNo description.
endpoint2_ystringoptionalNo description.
fill_colorstringoptionalNo description.
font_familystringoptionalNo description.
font_sizestringoptionalNo description.
heightstringoptionalNo description.
highlight_colorstringoptionalNo description.
italicstringoptionalNo description.
line_colorstringoptionalNo description.
line_shapestringoptionalNo description.
line_widthstringoptionalNo description.
linkstringoptionalNo description.
lockedstringoptionalNo description.
rotationstringoptionalNo description.
strikestringoptionalNo description.
stroke_stylestringoptionalNo description.
subscriptstringoptionalNo description.
superscriptstringoptionalNo description.
textstringoptionalNo description.
text_alignstringoptionalNo description.
text_areasstringoptionalNo description.
text_colorstringoptionalNo description.
text_v_alignstringoptionalNo description.
underlinestringoptionalNo description.
widthstringoptionalNo description.
xstringoptionalNo description.
ystringoptionalNo description.
lucidmcp_lucid_export_document_as_png#Export a page of a Lucid document as a PNG image.3 params

Export a page of a Lucid document as a PNG image.

NameTypeRequiredDescription
document_idstringrequiredNo description.
bounding_boxstringoptionalNo description.
pageintegeroptionalNo description.
lucidmcp_lucid_fetch_item_image#Fetch the source image attached to a specific item in a Lucid document.2 params

Fetch the source image attached to a specific item in a Lucid document.

NameTypeRequiredDescription
document_idstringrequiredNo description.
item_idstringrequiredNo description.
lucidmcp_lucid_get_document_metadata#Get metadata, access details, and owner information for a Lucid document.1 param

Get metadata, access details, and owner information for a Lucid document.

NameTypeRequiredDescription
document_idstringrequiredNo description.
lucidmcp_lucid_import_integration_cards#Import records from a connected third-party integration (e.g. Jira) into a Lucid document as linked cards.8 params

Import records from a connected third-party integration (e.g. Jira) into a Lucid document as linked cards.

NameTypeRequiredDescription
document_idstringrequiredNo description.
instance_idstringrequiredNo description.
integration_idstringrequiredNo description.
record_keysarrayrequiredNo description.
layoutstringoptionalNo description.
page_idstringoptionalNo description.
xnumberoptionalNo description.
ynumberoptionalNo description.
lucidmcp_lucid_list_folder_contents#List the documents and subfolders inside a Lucid folder. Omit folder_id to list the root folder.3 params

List the documents and subfolders inside a Lucid folder. Omit folder_id to list the root folder.

NameTypeRequiredDescription
folder_idstringoptionalNo description.
page_sizeintegeroptionalNo description.
page_tokenstringoptionalNo description.
lucidmcp_lucid_list_integrations#List the user's available third-party card integrations (e.g. Jira) and their connection status.0 params

List the user's available third-party card integrations (e.g. Jira) and their connection status.

lucidmcp_lucid_search_document#Locate regions of a Lucid document that contain specific text, returning page/region indexes you can pass to lucidmcp_fetch.2 params

Locate regions of a Lucid document that contain specific text, returning page/region indexes you can pass to lucidmcp_fetch.

NameTypeRequiredDescription
idstringrequiredNo description.
queriesarrayrequiredNo description.
lucidmcp_lucid_shape_details#Get default size, colors, and text-area/advanced properties for one or more Lucid shape classes.2 params

Get default size, colors, and text-area/advanced properties for one or more Lucid shape classes.

NameTypeRequiredDescription
class_namesarrayrequiredNo description.
document_idstringrequiredNo description.
lucidmcp_lucid_shape_library#Discover shapes/blocks available to insert into a Lucid document, by library, group, or search term.5 params

Discover shapes/blocks available to insert into a Lucid document, by library, group, or search term.

NameTypeRequiredDescription
document_idstringrequiredNo description.
group_idsstringoptionalNo description.
library_idstringoptionalNo description.
page_tokenstringoptionalNo description.
search_termstringoptionalNo description.
lucidmcp_lucid_submit_feedback#Submit user feedback, a bug report, or a feature request about the Lucid MCP server to Lucid's product team.2 params

Submit user feedback, a bug report, or a feature request about the Lucid MCP server to Lucid's product team.

NameTypeRequiredDescription
feedbackstringrequiredNo description.
titlestringrequiredNo description.
lucidmcp_lucid_update_document#Update a Lucid document's title, parent folder, or custom tags. At least one of title, parent, or custom_tags must be provided.4 params

Update a Lucid document's title, parent folder, or custom tags. At least one of title, parent, or custom_tags must be provided.

NameTypeRequiredDescription
document_idstringrequiredNo description.
custom_tagsstringoptionalNo description.
parentstringoptionalNo description.
titlestringoptionalNo description.
lucidmcp_lucid_update_folder#Rename a Lucid folder or move it to a different parent. At least one of name or parent must be provided.3 params

Rename a Lucid folder or move it to a different parent. At least one of name or parent must be provided.

NameTypeRequiredDescription
folder_idintegerrequiredNo description.
namestringoptionalNo description.
parentstringoptionalNo description.
lucidmcp_post_document_thread_comment#Post a new comment to an existing collaboration thread on a Lucid document.3 params

Post a new comment to an existing collaboration thread on a Lucid document.

NameTypeRequiredDescription
contentstringrequiredNo description.
document_idstringrequiredNo description.
thread_idstringrequiredNo description.
lucidmcp_share_document_with_collaborators#Share a Lucid document with collaborators by granting them access via email.3 params

Share a Lucid document with collaborators by granting them access via email.

NameTypeRequiredDescription
document_idstringrequiredNo description.
emailsarrayrequiredNo description.
rolestringoptionalNo description.