MCP server for integration with Lucid App that enables multimodal LLMs to access, search, and analyze Lucid diagrams (LucidChart, LucidSpark, LucidScale) through visual export and AI-powered analysis.

Installation

Smithery

npx -y @smithery/cli install @smartzan63/lucid-mcp-server --client claude

NPM Global

npm install -g lucid-mcp-server

MCP Inspector

npx @modelcontextprotocol/inspector lucid-mcp-server

Configuration

Manual VS Code Setup

{
  "mcp": {
    "servers": {
      "lucid-mcp-server": {
        "type": "stdio",
        "command": "lucid-mcp-server",
        "env": {
          "LUCID_API_KEY": "${input:lucid_api_key}",
          "AZURE_OPENAI_API_KEY": "${input:azure_openai_api_key}",
          "AZURE_OPENAI_ENDPOINT": "${input:azure_openai_endpoint}",
          "AZURE_OPENAI_DEPLOYMENT_NAME": "${input:azure_openai_deployment_name}",
          "OPENAI_API_KEY": "${input:openai_api_key}",
          "OPENAI_MODEL": "${input:openai_model}"
        }
      }
    }
  }
}

Available Tools

Tool	Description
`search-documents`	Lists documents in your Lucid account with the ability to filter by keywords
`get-document`	Retrieves document metadata and can optionally perform AI analysis of its visual content
`get-document-tabs`	Retrieves lightweight metadata about all tabs (pages) in a Lucid document without loading full content

Features

Document discovery and metadata retrieval from LucidChart, LucidSpark, and LucidScale
Lightweight tab metadata for quick document structure preview
PNG image export from Lucid diagrams
Diagram analysis using AI and multimodal LLMs (supports Azure OpenAI and OpenAI)
API key management via environment variables with automatic fallback from Azure to OpenAI
TypeScript implementation with full test coverage
Integration with MCP Inspector for convenient testing

Environment Variables

Required

LUCID_API_KEY - API key from Lucid developer portal for accessing Lucid services

Optional

AZURE_OPENAI_API_KEY - Azure OpenAI API key for AI-powered diagram analysis (takes priority over OpenAI)
AZURE_OPENAI_ENDPOINT - Azure OpenAI endpoint URL
AZURE_OPENAI_DEPLOYMENT_NAME - Azure OpenAI deployment name (e.g., gpt-4o)
OPENAI_API_KEY - OpenAI API key, used as a fallback if Azure is not configured
OPENAI_MODEL - OpenAI model to use (defaults to gpt-4o)

Usage Examples

Show me all my Lucid documents

Get information about document with ID: [document-id]

Analyze this diagram: [document-id]

What does this Lucid diagram show: [document-id]

Notes

The server automatically uses Azure OpenAI if AZURE_OPENAI_API_KEY is set, otherwise it falls back to OpenAI. Only the Lucid API key is required for basic document operations — AI analysis features require Azure OpenAI or OpenAI configuration.

lucid-mcp-server MCP Server

Get this MCP server