io.github.TopLocalAI/layerback-mcp
Convert diagram images into fully editable Visio (VSDX), PowerPoint, draw.io, and SVG files.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
layerback-mcpclaude mcp add layerback-mcp -e 'LAYERBACK_API_KEY=<your layerback_api_key>' -- npx -y layerback-mcp@0.1.2
{
"mcpServers": {
"layerback-mcp": {
"command": "npx",
"args": [
"-y",
"layerback-mcp@0.1.2"
],
"env": {
"LAYERBACK_API_KEY": "<your layerback_api_key>"
}
}
}
}
Environment variables
LAYERBACK_API_KEYrequired secret LayerBack API key from https://layerback.com/settings/apikeys
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
LayerBack MCP Server
Give your AI agent the one diagram skill it's missing: turning pictures of diagrams into fully editable files.
Agents can write Mermaid — but when the input is a screenshot, a whiteboard photo, or a diagram trapped in a PDF page, they're stuck. This MCP server connects any MCP-compatible agent (Claude Desktop, Claude Code, Cursor, …) to LayerBack, which rebuilds every shape, connector, and label as a native object and returns Visio (VSDX), PowerPoint (PPTX), draw.io, and SVG — all editable, from one conversion.
Tools
| Tool | What it does |
|---|---|
convert_diagram_image | Convert a local image file (PNG/JPG/WebP); waits for the result by default (~30–60 s) |
get_conversion_status | Poll a running job |
download_converted_diagram | Save any output format to a local path |
Setup
- Create an API key at https://layerback.com/settings/apikeys (new accounts include free credits — one conversion costs 10 and includes every output format).
- Add the server to your MCP client config:
{
"mcpServers": {
"layerback": {
"command": "npx",
"args": ["-y", "layerback-mcp"],
"env": { "LAYERBACK_API_KEY": "your-key-here" }
}
}
}
Example prompts
- "Convert ~/Desktop/whiteboard.jpg into a Visio file and save it to my Downloads folder."
- "Here's a screenshot of our architecture diagram — rebuild it as an editable draw.io file."
- "Batch-convert every PNG in ./legacy-diagrams to VSDX."
Notes
- Requires Node 18+.
- REST API docs: https://layerback.com/docs/api · OpenAPI: https://layerback.com/openapi.yaml
- Files upload to LayerBack for conversion and are deleted within 72 hours.
MIT © LayerBack
Frequently asked questions
What is io.github.TopLocalAI/layerback-mcp?
Convert diagram images into fully editable Visio (VSDX), PowerPoint, draw.io, and SVG files.
How do I install io.github.TopLocalAI/layerback-mcp?
It runs on your machine. In Claude Code: claude mcp add layerback-mcp -e 'LAYERBACK_API_KEY=<your layerback_api_key>' -- npx -y layerback-mcp@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.TopLocalAI/layerback-mcp need an API key?
Yes. It expects LAYERBACK_API_KEY, which you set in its configuration.
Is io.github.TopLocalAI/layerback-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.TopLocalAI/layerback-mcp?
It is published by TopLocalAI. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.