Mathematica Server

codecov Build Python Version License PyPI version

MCP server that wraps Mathematica's wolframscript command-line interface. It provides tools to evaluate Wolfram Language code and retrieve information about the Wolfram Engine installation.

Background

• Wolfram Language: symbolic programming language e.g. Integrate[x*Sin[x], x]
• Wolfram Engine: kernel for running Wolfram Language code
• WolframScript: command-line interface to Wolfram Engine
• Mathematica: notebook interface to Wolfram Engine

Both Wolfram Engine and WolframScript are freely available for personal use.

Installation

1. Please ensure WolframScript is installed and activated on your system.

wolframscript -version
wolframscript -activate
wolframscript -code "Integrate[x*Sin[x], x]"

2. Install the uv package manager.

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Edit the Claude Desktop config file and add the mathematica-mcp server. Note that uvx sets up an environment, installs the mathematica-mcp package, and runs the server by calling the mathematica-mcp entry point defined in pyproject.toml. No cloning of the repository is necessary. The logs are written to the default user log directory, e.g. ~/Library/Logs/mathematica_mcp/mathematica_mcp.log on macOS.

{
  "mcpServers": {
    "mathematica-mcp": {
      "command": "uvx",
      "args": [
        "mathematica-mcp"
      ]
    }
  }
}

Claude Desktop config file on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

4. Alternatively, you can clone the repository and then modify or extend the MCP server code. In this case, make sure to update the path to the local repository in the Claude Desktop config file.

{
  "mcpServers": {
    "mathematica-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/lars/Code/mathematica-mcp",
        "run",
        "mathematica-mcp"
      ]
    }
  }
}

Claude Desktop config file on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json