Run MATLAB® using AI applications with the official MATLAB MCP Server from MathWorks®. This MCP server for MATLAB supports a wide range of coding agents like Cl
Run MATLAB® using AI applications with the official MATLAB MCP Server from MathWorks®. This MCP server for MATLAB supports a wide range of coding agents like Cl
English • Español • 日本語 • 한국어 • 简体中文
Run MATLAB® using AI applications with the official MATLAB MCP Server from MathWorks®. The MATLAB MCP Server allows your AI applications to:
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.
Install MATLAB (MathWorks) R2021a or later and add it to the system PATH.
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:
For Windows or Linux, Download the Latest Release. (Alternatively, you can build from source: install Go and build the binary using go install github.com/matlab/matlab-mcp-server/cmd/matlab-mcp-server@latest).
For macOS, first download the latest release by running the following command in your terminal:
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
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.
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
You install the MATLAB MCP Server in Claude Desktop using the MATLAB MCP Server bundle.
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.
Download the MATLAB MCP Server bundle matlab-mcp-server.mcpb from the Latest Release page.
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.
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).
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
WINDIRenvironment 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 addenv_vars = ["WINDIR"]to the[mcp_servers.matlab]section:[mcp_servers.matlab] command = 'C:\fullpath\to\matlab-mcp-server-windows-x64.exe' args = [] env_vars = ["WINDIR"]
Customize the behavior of the server by specifying arguments in one of these ways:
.json file).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.| Argument | Description | Example |
|---|---|---|
| help | Displays help information for all arguments. | --help |
| version | Displays the version of the MATLAB MCP Server. | --version |
| matlab-root | Full path specifying which MATLAB to start. Do not include /bin in the path. By default, the server tries to find the first MATLAB on the system PATH. |
Windows: --matlab-root=C:\\Program Files\\MATLAB\\R2026a |
Linux/macOS: --matlab-root=/home/usr/MATLAB/R2026a
As an environment variable: MW_MCP_SERVER_MATLAB_ROOT=/home/usr/MATLAB/R2026a |
| initialize-matlab-on-startup | To initialize MATLAB as soon as you start the server, set this argument to true. By default, MATLAB only starts when the first tool is called. | --initialize-matlab-on-startup=true |
| initial-working-folder | Specify the folder where MATLAB starts. If you do not specify a value, MATLAB starts at the path of your AI application's first Root (MCP). If you have not defined a root, MATLAB starts in these locations:
Linux: /home/username
Windows: C:\Users\\username\Documents
Mac: /Users/username/Documents
| Windows: --initial-working-folder=C:\\Users\\\username\\MyProject
Linux/macOS: --initial-working-folder=/Users/username/MyProject |
| matlab-display-mode | Specify whether to show the MATLAB desktop. Use desktop mode (default) to show the MATLAB desktop. Use nodesktop mode to use MATLAB only from your AI application, without the MATLAB desktop. Note that in nodesktop mode, commands requiring a graphical interface (such as edit, open, open_system, uifigure, and appdesigner) will still open MATLAB windows on your desktop. | --matlab-display-mode=nodesktop |
| matlab-session-mode | Specify whether the MCP server starts a new MATLAB or connects to an existing MATLAB session (supported for MATLAB R2023a onwards). The default is auto mode.
new mode: The MCP server starts a new MATLAB session.
auto mode (default): The server tries to connect to an existing MATLAB session, which you must have configured for existing mode using the instructions below. If the server is unable to find an existing MATLAB session, it starts a new one.
existing mode: The server tries to connect to an existing MATLAB session. Do not use this mode in conjunction with the arguments matlab-root, initial-working-folder, or matlab-display-mode. You must have configured your MATLAB session beforehand to use this mode, with these steps:
If you are using existing mode for the first time, run ./matlab-mcp-server --setup-matlab.
This command installs an add-on named MATLAB MCP Server Toolbox in MATLAB. You can customize the command with other arguments from this table. For example, to specify which MATLAB to use to install the toolbox, you can use ./matlab-mcp-server --setup-matlab --matlab-root=/home/usr/MATLAB/R2026a.
For Claude Desktop, you must download the MATLAB MCP Server binary using the instructions in Setup before you run ./matlab-mcp-server --setup-matlab.
In the command window of a running MATLAB session, run shareMATLABSession(). The MCP server will connect to this MATLAB when you start the server with --matlab-session-mode=existing or --matlab-session-mode=auto. If you are running multiple MATLAB sessions, the server connects to the MATLAB session where you most recently ran the command shareMATLABSession().
As an alternative to running shareMATLABSession() manually, you can add the command to your MATLAB Startup Script (MathWorks).
| --matlab-session-mode=existing |
| extension-file | To use custom MCP tools, provide a path to a JSON file that defines your tools. You can also use multiple extension files. For details on using custom tools, see Use Custom Tools with the MATLAB MCP Server. |
Windows: --extension-file=C:\\Users\\name\\my-tools.json
Linux/macOS: --extension-file=/path/to/my-tools.json
Using multiple extension files:
Windows:--extension-file=C:\\path\\to\\tools-1.json --extension-file=C:\\path\\to\\tools-2.json
Linux/macOS:--extension-file=/path/to/tools1.json --extension-file=/path/to/tools2.json
Using environment variables:
Windows: MW_MCP_SERVER_EXTENSION_FILE=C:\Users\name\tools1.json;C:\Users\name\tools2.json
Linux/macOS: MW_MCP_SERVER_EXTENSION_FILE=/path/to/tools1.json:/path/to/tools2.json |
| log-folder | Specify the folder where the MCP server stores log files. If not specified, the server uses the default temporary folder of your operating system. | Wi
No open issues yet, or sync has not completed.