

<!DOCTYPE html>

<html lang="en-US">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=Edge">

  <link rel="stylesheet" href="/Visio-Desktop-MCP-Server/assets/css/just-the-docs-default.css">

  <link rel="stylesheet" href="/Visio-Desktop-MCP-Server/assets/css/just-the-docs-head-nav.css" id="jtd-head-nav-stylesheet">

  <style id="jtd-nav-activation">
  
    .site-nav ul li a {
      background-image: none;
    }

  </style>

  

  
    <script src="/Visio-Desktop-MCP-Server/assets/js/vendor/lunr.min.js"></script>
  

  <script src="/Visio-Desktop-MCP-Server/assets/js/just-the-docs.js"></script>

  <meta name="viewport" content="width=device-width, initial-scale=1">

  

  <link rel="icon" href="/Visio-Desktop-MCP-Server/favicon.ico" type="image/x-icon">



  <!-- Begin Jekyll SEO tag v2.8.0 -->
<title>Visio Desktop MCP Server | Create, understand, and update editable Visio diagrams with your AI agent.</title>
<meta name="generator" content="Jekyll v3.10.0" />
<meta property="og:title" content="Visio Desktop MCP Server" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Create, understand, and update editable Visio diagrams with your AI agent." />
<meta property="og:description" content="Create, understand, and update editable Visio diagrams with your AI agent." />
<link rel="canonical" href="https://microsoft.github.io/Visio-Desktop-MCP-Server/assets/css/just-the-docs-head-nav.css" />
<meta property="og:url" content="https://microsoft.github.io/Visio-Desktop-MCP-Server/assets/css/just-the-docs-head-nav.css" />
<meta property="og:site_name" content="Visio Desktop MCP Server" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta property="twitter:title" content="Visio Desktop MCP Server" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","description":"Create, understand, and update editable Visio diagrams with your AI agent.","headline":"Visio Desktop MCP Server","url":"https://microsoft.github.io/Visio-Desktop-MCP-Server/assets/css/just-the-docs-head-nav.css"}</script>
<!-- End Jekyll SEO tag -->


  <link rel="icon" href="/Visio-Desktop-MCP-Server/assets/images/favicon.svg" type="image/svg+xml">
<link rel="apple-touch-icon" href="/Visio-Desktop-MCP-Server/assets/images/apple-touch-icon.png">
<meta name="theme-color" content="#2456ce">
<script>
  (function () {
    var storageKey = "visio-docs-theme";
    var darkId = "visio-dark-stylesheet";
    var darkHref = "/Visio-Desktop-MCP-Server/assets/css/just-the-docs-visio-dark.css";
    var media = window.matchMedia ? window.matchMedia("(prefers-color-scheme: dark)") : null;

    function stored() {
      try { return localStorage.getItem(storageKey); } catch (e) { return null; }
    }

    function preferred() {
      var theme = stored();
      if (theme === "dark" || theme === "light") return theme;
      return media && media.matches ? "dark" : "light";
    }

    function apply(theme) {
      var dark = theme === "dark";
      var darkLink = document.getElementById(darkId);
      if (!darkLink && dark && document.readyState !== "loading") {
        darkLink = document.createElement("link");
        darkLink.rel = "stylesheet";
        darkLink.id = darkId;
        darkLink.href = darkHref;
        document.head.appendChild(darkLink);
      }
      if (darkLink) darkLink.disabled = !dark;
      document.documentElement.style.backgroundColor = dark ? "#0f1724" : "";
      document.documentElement.style.colorScheme = dark ? "dark" : "";
      document.documentElement.setAttribute("data-theme", theme);
      var meta = document.querySelector('meta[name="theme-color"]');
      if (meta) meta.setAttribute("content", theme === "dark" ? "#0f1724" : "#2456ce");
      var button = document.getElementById("theme-toggle");
      if (button) {
        var label = theme === "dark" ? "Switch to light mode" : "Switch to dark mode";
        button.setAttribute("aria-label", label);
        button.setAttribute("title", label);
        button.setAttribute("aria-pressed", theme === "dark" ? "true" : "false");
      }
    }

    // A parser-inserted stylesheet blocks first paint; swapping href from script does not.
    if (preferred() === "dark") {
      document.write('<link rel="stylesheet" id="' + darkId + '" href="' + darkHref + '">');
    }
    apply(preferred());

    if (media) {
      var onChange = function () { if (!stored()) apply(preferred()); };
      if (media.addEventListener) media.addEventListener("change", onChange);
      else if (media.addListener) media.addListener(onChange);
    }

    document.addEventListener("DOMContentLoaded", function () {
      var button = document.getElementById("theme-toggle");
      if (!button) return;
      apply(preferred());
      button.addEventListener("click", function () {
        var next = document.documentElement.getAttribute("data-theme") === "dark" ? "light" : "dark";
        try { localStorage.setItem(storageKey, next); } catch (e) {}
        apply(next);
      });
    });
  })();
</script>
<script>
  document.addEventListener("DOMContentLoaded", function () {
    var nav = document.getElementById("site-nav");
    if (!nav) return;
    function update() {
      var max = nav.scrollHeight - nav.clientHeight;
      nav.classList.toggle("nav-fade-top", nav.scrollTop > 1);
      nav.classList.toggle("nav-fade-bottom", max - nav.scrollTop > 1);
    }
    nav.addEventListener("scroll", update, { passive: true });
    window.addEventListener("resize", update);
    if (window.ResizeObserver) {
      var observer = new ResizeObserver(update);
      observer.observe(nav);
      Array.prototype.forEach.call(nav.children, function (child) {
        observer.observe(child);
      });
    }
    update();
  });
</script>


</head>

<body>
  <a class="skip-to-main" href="#main-content">Skip to main content</a>
  <svg xmlns="http://www.w3.org/2000/svg" class="d-none">
  <symbol id="svg-link" viewBox="0 0 24 24">
  <title>Link</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link">
    <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path>
  </svg>
</symbol>

  <symbol id="svg-menu" viewBox="0 0 24 24">
  <title>Menu</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu">
    <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line>
  </svg>
</symbol>

  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
  <title>Expand</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right">
    <polyline points="9 18 15 12 9 6"></polyline>
  </svg>
</symbol>

  <!-- Feather. MIT License: https://github.com/feathericons/feather/blob/master/LICENSE -->
<symbol id="svg-external-link" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-external-link">
  <title id="svg-external-link-title">(external link)</title>
  <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line>
</symbol>

  
    <symbol id="svg-doc" viewBox="0 0 24 24">
  <title>Document</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file">
    <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline>
  </svg>
</symbol>

    <symbol id="svg-search" viewBox="0 0 24 24">
  <title>Search</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search">
    <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line>
  </svg>
</symbol>

  
  
    <!-- Bootstrap Icons. MIT License: https://github.com/twbs/icons/blob/main/LICENSE.md -->
<symbol id="svg-copy" viewBox="0 0 16 16">
  <title>Copy</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16">
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1v-1z"/>
    <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3z"/>
  </svg>
</symbol>
<symbol id="svg-copied" viewBox="0 0 16 16">
  <title>Copied</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard-check-fill" viewBox="0 0 16 16">
    <path d="M6.5 0A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3Zm3 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3Z"/>
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1A2.5 2.5 0 0 1 9.5 5h-3A2.5 2.5 0 0 1 4 2.5v-1Zm6.854 7.354-3 3a.5.5 0 0 1-.708 0l-1.5-1.5a.5.5 0 0 1 .708-.708L7.5 10.793l2.646-2.647a.5.5 0 0 1 .708.708Z"/>
  </svg>
</symbol>

  
</svg>

  
    <header class="side-bar">
  <div class="site-header">
    <a href="/Visio-Desktop-MCP-Server/" class="site-title lh-tight">
  Visio Desktop MCP Server

</a>
    <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false">
      <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg>
    </button>
  </div>

  <nav aria-label="Main" id="site-nav" class="site-nav">
  
  
    <ul class="nav-list"><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/" class="nav-list-link">Overview</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Set up submenu" aria-expanded="false">
        <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
      </button><a href="/Visio-Desktop-MCP-Server/setup/" class="nav-list-link">Set up</a><ul class="nav-list"><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/setup/prerequisites/" class="nav-list-link">Prerequisite checks</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/setup/clients/" class="nav-list-link">Client configuration</a></li></ul></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/first-diagram/" class="nav-list-link">First diagram</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/work-with-diagrams/" class="nav-list-link">Work with diagrams</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/validate-and-export/" class="nav-list-link">Validate and export</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Tool reference submenu" aria-expanded="false">
        <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
      </button><a href="/Visio-Desktop-MCP-Server/tools/" class="nav-list-link">Tool reference</a><ul class="nav-list"><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/manage-visio/" class="nav-list-link">manage_visio</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/manage-document/" class="nav-list-link">manage_document</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/create-diagram/" class="nav-list-link">create_diagram</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/read-diagram/" class="nav-list-link">read_diagram</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/update-diagram/" class="nav-list-link">update_diagram</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/validate-diagram/" class="nav-list-link">validate_diagram</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/get-visual-model-schema/" class="nav-list-link">get_visual_model_schema</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/content-search/" class="nav-list-link">content_search</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/tools/visual-model/" class="nav-list-link">Visual Model payloads</a></li></ul></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/custom-content/" class="nav-list-link">Work with Custom Content</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Custom agents submenu" aria-expanded="false">
        <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
      </button><a href="/Visio-Desktop-MCP-Server/custom-agents/" class="nav-list-link">Custom agents</a><ul class="nav-list"><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/custom-agents/sample/" class="nav-list-link">Sample agent</a></li></ul></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/examples/" class="nav-list-link">Examples and best practices</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Configuration submenu" aria-expanded="false">
        <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
      </button><a href="/Visio-Desktop-MCP-Server/configuration/" class="nav-list-link">Configuration</a><ul class="nav-list"><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/configuration/runtime/" class="nav-list-link">Runtime and discovery</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/configuration/logging/" class="nav-list-link">Logging and diagnostics</a></li></ul></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/privacy/" class="nav-list-link">Privacy and control</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/troubleshooting/" class="nav-list-link">Troubleshooting</a></li><li class="nav-list-item"><a href="/Visio-Desktop-MCP-Server/support/" class="nav-list-link">Help and feedback</a></li></ul>
  
</nav>


<div class="d-md-block d-none site-footer">
  
  
    <!-- Optional navigation footer intentionally left blank. -->
  
  </div>
</header>

  
  <div class="main" id="top">
    <div id="main-header" class="main-header">
  
    

<div class="search" role="search">
  <div class="search-input-wrap">
    <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search Visio Desktop MCP Server" autocomplete="off">
    <label for="search-input" class="search-label">
      <span class="sr-only">Search Visio Desktop MCP Server</span>
      <svg viewBox="0 0 24 24" class="search-icon" aria-hidden="true"><use xlink:href="#svg-search"></use></svg>
    </label>
  </div>
  <div id="search-results" class="search-results"></div>
</div>

  
  <button type="button" class="theme-toggle" id="theme-toggle" aria-label="Switch to dark mode" title="Switch to dark mode">
  <svg class="theme-toggle-moon" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true" focusable="false"><path fill="currentColor" d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg>
  <svg class="theme-toggle-sun" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true" focusable="false"><circle cx="12" cy="12" r="4.5" fill="currentColor"/><g stroke="currentColor" stroke-width="2" stroke-linecap="round"><path d="M12 1.5v2.5M12 20v2.5M1.5 12H4M20 12h2.5M4.6 4.6l1.8 1.8M17.6 17.6l1.8 1.8M4.6 19.4l1.8-1.8M17.6 6.4l1.8-1.8"/></g></svg>
</button>

  
    <nav aria-label="Auxiliary" class="aux-nav">
  <ul class="aux-nav-list">
    
      <li class="aux-nav-list-item">
        <a href="https://github.com/microsoft/Visio-Desktop-MCP-Server" class="site-button"
          
        >
          GitHub
        </a>
      </li>
    
  </ul>
</nav>

  
</div>

    <div class="main-content-wrap">
      
      <div id="main-content" class="main-content">
        <main>
          
            

          

          
            
          
        </main>
        
<hr>
<footer>
  
    <p><a href="#top" id="back-to-top">Back to top</a></p>
  

  

  <div class="d-md-none mt-4 fs-2">
    
    
      <!-- Optional navigation footer intentionally left blank. -->
    
  </div>
</footer>

      </div>
    </div>
    
      

<div class="search-overlay"></div>

    
  </div>

  
</body>
</html>

