MATLAB MCP Server

English •

•

•

•

Run MATLAB® using AI applications with the official MATLAB MCP Server from MathWorks®. The MATLAB MCP Server allows your AI applications to:

• Start and quit MATLAB.
• Write and run MATLAB code.
• Assess your MATLAB code for style and correctness.

To assist your agent in using MATLAB and Simulink, you can use skills from MATLAB Agentic Toolkit (GitHub) and Simulink Agentic Toolkit (GitHub), which can also install this MCP server for you.

Table of Contents

• Setup
  • Claude Code
  • Claude Desktop
  • GitHub Copilot in Visual Studio Code
  • Codex
• Arguments
• Tools
• Resources
• Data Collection
• Security Considerations
• Licensing and Usage
• Contact Support

Setup

1. Install MATLAB (MathWorks) R2021a or later and add it to the system PATH.

1. The server supports any AI application that uses Model Context Protocol. To set up the MATLAB MCP Server for Claude Desktop, skip to the instructions for Claude Desktop. To set up the server for other applications, follow these instructions:

curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-arm64

curl -L -o ~/Downloads/matlab-mcp-server https://github.com/matlab/matlab-mcp-server/releases/latest/download/matlab-mcp-server-macos-x64

Then grant executable permissions to the downloaded binary so you can run the MATLAB MCP Server:

chmod +x ~/Downloads/matlab-mcp-server

1. Add the MATLAB MCP Server to your AI application. You can find instructions for adding MCP servers in the documentation of your AI application. For example instructions on using Claude Code®, Claude Desktop®, and GitHub Copilot in Visual Studio® Code, see below. Note that you can customize the server by specifying optional Arguments.

Claude Code

In your terminal, run the following, remembering to insert the full path to the server binary you acquired in the setup:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary

You can customize the server by specifying optional Arguments. Note the `--` separator between Claude Code's options and the server arguments:

claude mcp add --transport stdio matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

For details on adding MCP servers in Claude Code, see Add a local stdio server (Claude Code). To remove the server later, run:

claude mcp remove matlab

Claude Desktop

You install the MATLAB MCP Server in Claude Desktop using the MATLAB MCP Server bundle.

1. Install the Filesystem extension in Claude Desktop to allow Claude to read and write files on your system. In Claude Desktop, click Settings > Extensions > Browse extensions. Search for the Filesystem extension developed by Anthropic and click Install. Specify the folders you want to allow the MCP server to access, then toggle the Disabled button to Enable the Filesystem extension.

2. Download the MATLAB MCP Server bundle `matlab-mcp-server.mcpb` from the Latest Release page.

3. To install the MATLAB MCP Server bundle as a desktop extension, double click the downloaded `matlab-mcp-server.mcpb` file and click Install in Claude Desktop. (Alternatively, navigate in Claude to File menu > Settings > Extensions > Advanced Settings > Install Extension and select the `matlab-mcp-server.mcpb` file. Click Install).

To customize the behaviour of the MATLAB MCP Server, navigate to Settings > Extensions > Configure, where you can modify the server's Arguments.

GitHub Copilot in Visual Studio Code

In your VS Code workspace, create a file named `.vscode/mcp.json`. Insert the following JSON, remembering to specify the full path to the server binary you acquired in the setup, as well as any Arguments. Then save the file. (Note that on Windows, your paths require extra slashes as escape characters).

{
    "servers": {
        "matlab": {
            "type": "stdio",
            "command": "C:\\fullpath\\to\\matlab-mcp-server-windows-x64.exe",
            "args": []
        }
    }
}

For more information about using MCP servers in VS Code, see Add and Manage MCP servers in VS Code (VS Code).

Codex

In your terminal, run the following, remembering to insert the full path to the server binary you acquired in the setup:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary

You can customize the server by specifying optional Arguments. For example:

codex mcp add matlab -- /fullpath/to/matlab-mcp-server-binary --initial-working-folder=/home/username/myproject

> [!NOTE]

> Windows users: Codex does not forward the `WINDIR` environment variable, which you need to run MATLAB and Simulink (see #32).

>

> To add the variable, open your Codex config file at `C:\Users\\.codex\config.toml`, and add `env_vars = ["WINDIR"]` to the `[mcp_servers.matlab]` section:

>

> ```toml

> [mcp_servers.matlab]

> command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe'

> args = []

> env_vars = ["WINDIR"]

> ```

Arguments

Customize the behavior of the server by specifying arguments in one of these ways:

• Insert the arguments in the configuration settings of your AI application (usually a `.json` file).
• Enter the arguments as command-line interface (CLI) flags when you start the server.
• Use environment variables, specified either in your CLI or application's configuration settings. To derive the environment variable name from a CLI flag, add the prefix `MW_MCP_SERVER_`, convert to uppercase, and replace hyphens (`-`) with underscores (`_`). For example, the argument `--matlab-root` becomes the environment variable `MW_MCP_SERVER_MATLAB_ROOT`. CLI flags take precedence over environment variables, if you use both.

Tools

1. `detect_matlab_toolboxes`

1. `check_matlab_code`

1. `evaluate_matlab_code`

1. `run_matlab_file`

1. `run_matlab_test_file`

Resources

The MCP server provides Resources (MCP) to help your AI application write MATLAB code. To see instructions for using this resource, refer to the documentation of your AI application that explains how to use resources.

1. `matlab_coding_guidelines`

1. `plain_text_live_code_guidelines`

Data Collection

The MATLAB MCP Server may collect fully anonymized information about your usage of the server and send it to MathWorks. This data collection helps MathWorks improve products and is on by default. To opt out of data collection, set the argument `--disable-telemetry` to `true`.

Security Considerations

When using the MATLAB MCP Server, you should thoroughly review and validate all tool calls before you run them. Always keep a human in the loop for important actions and only proceed once you are confident the call will do exactly what you expect. For more information, see User Interaction Model (MCP) and Security Considerations (MCP).

Licensing and Usage

The license is available in the LICENSE.md file in this GitHub repository.

MCP servers are only permitted to be used with MATLAB in accordance with the MathWorks Software License Agreement, and must not be shared by multiple users. Contact MathWorks if you need to support shared or centralized server use.

Contact Support

MathWorks encourages you to use this repository and provide feedback. To request technical support or submit an enhancement request, create a GitHub issue or contact MathWorks Technical Support.

Copyright 2025-2026 The MathWorks, Inc.