codex-visio-mcp

Windows setup scripts for installing and verifying visio-mcp as a global Codex MCP server for Microsoft Visio.

This repository is a small, reproducible setup wrapper around the upstream visio-mcp package. It does not vendor the upstream package source. The goal is to make a working Codex global MCP setup easy to install, verify, and share.

What This Enables

After installation and a Codex restart, Codex can use local Microsoft Visio to:

• create Visio documents and standard diagram templates
• draw network diagrams, UML diagrams, flowcharts, ERDs, BPMN diagrams, and more
• add and format shapes
• connect shapes with Visio connectors
• save .vsdx files
• export pages as images

Requirements

• Windows
• Microsoft Visio desktop app installed
• Python 3.14 or newer available as python
• Codex Desktop

Quick Install

Run PowerShell from this repository:

powershell -ExecutionPolicy Bypass -File .\scripts\install-visio-mcp.ps1

The installer:

1. Creates an isolated virtual environment at %USERPROFILE%\.codex\tools\visio-mcp\.venv
2. Installs visio-mcp==0.1.2
3. Backs up %USERPROFILE%\.codex\config.toml
4. Adds or replaces the global [mcp_servers.visio] entry

Restart Codex after installation.

Verify

Run:

powershell -ExecutionPolicy Bypass -File .\scripts\verify-visio-mcp.ps1

The verifier checks:

• the Codex MCP config entry
• Python imports for visio_mcp, mcp, and win32com.client
• MCP startup over stdio
• key tools such as create_diagram, batch_draw_shapes, batch_connect_shapes, and export_page_as_image

Manual Codex Config

If you prefer manual setup, add this to %USERPROFILE%\.codex\config.toml. Adjust the path if you install somewhere else.

[mcp_servers.visio]
args = ["-m", "visio_mcp"]
command = "C:\\Users\\YOUR_NAME\\.codex\\tools\\visio-mcp\\.venv\\Scripts\\python.exe"
startup_timeout_sec = 120

See codex.config.example.toml for the same snippet.

Example Output

The following network topology was generated through the configured Visio MCP.

Notes

• Visio is controlled through Windows COM automation, so this works only with the desktop Visio application, not Visio for the web.
• The first real drawing call may open or focus Visio.
• This project is a configuration and setup helper. The MCP implementation comes from the upstream visio-mcp Python package.

License

MIT