mathematica-mcp-full 0.3.0

Full GUI control of Mathematica notebooks and kernel via Model Context Protocol

Mathematica MCP

Give your AI Agent the power of Wolfram Language.

---

What is this?

This MCP Server empowers AI Agents & IDEs (like Claude Desktop, Cursor, or OpenCode) with a direct interface to your local Wolfram Engine. It enables your agent to perform symbolic reasoning, precise calculation, and interactive visualization natively.

Capabilities:

• Execute Code: Run Wolfram Language expressions in a secure sandbox.
• Self-Correct: Diagnose and fix syntax errors automatically.
• Visualize: Generate high-fidelity plots and export them as images.
• Analyze Notebooks: Parse and manipulate .nb files contextually.
• Persist State: Maintain a stateful session (e.g. x = 5) across interactions.

Watch it in action

---

Quick Start

Prerequisites

Before installing, you need:

1. Mathematica 14.0+ with wolframscript in your PATH

   • Download Mathematica
   • macOS: Add to ~/.zshrc: export PATH="/Applications/Mathematica.app/Contents/MacOS:$PATH"

2. uv package manager

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

One-Command Setup (Recommended)

# For Claude Desktop
uvx mathematica-mcp-full setup claude-desktop

# For Cursor
uvx mathematica-mcp-full setup cursor

# For VS Code (requires GitHub Copilot Chat extension)
uvx mathematica-mcp-full setup vscode

# For OpenAI Codex CLI
uvx mathematica-mcp-full setup codex

# For Google Gemini CLI
uvx mathematica-mcp-full setup gemini

# For Claude Code CLI
uvx mathematica-mcp-full setup claude-code

Then restart Mathematica and your editor. Done!

VS Code: Alternative setup via Command Palette

Prerequisite: GitHub Copilot Chat extension must be installed - MCP support is built into Copilot.

1. Press Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows)
2. Type "MCP" → Select "MCP: Add Server"
3. Choose "Command (stdio)" — not "pip"
4. Enter command: uvx
5. Enter args: mathematica-mcp-full
6. Name it: mathematica
7. Choose scope: Workspace or User

Alternative: Interactive Installer

bash <(curl -sSL https://raw.githubusercontent.com/AbhiRawat4841/mathematica-mcp/main/install.sh)

Verify Installation

uvx mathematica-mcp-full doctor

Tip: If you encounter errors after updating, clear the cache:

uv cache clean mathematica-mcp-full && uvx mathematica-mcp-full setup <client>

---

Manual Installation

Click to expand manual setup instructions

1. Clone & Install:

   git clone https://github.com/AbhiRawat4841/mathematica-mcp.git
   cd mathematica-mcp
   uv sync
   

2. Install Mathematica Addon:

   wolframscript -file addon/install.wl
   

   Restart Mathematica after this step.

3. Configure your editor (replace path with your actual path):

   Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "mathematica": {
         "command": "uv",
         "args": ["--directory", "/path/to/mathematica-mcp", "run", "mathematica-mcp-full"]
       }
     }
   }
   

   Cursor (~/.cursor/mcp.json):

   {
     "mcpServers": {
       "mathematica": {
         "command": "uv",
         "args": ["--directory", "/path/to/mathematica-mcp", "run", "mathematica-mcp-full"]
       }
     }
   }
   

   VS Code (~/.vscode/mcp.json):

   Note: VS Code MCP requires GitHub Copilot Chat extension.

   {
     "servers": {
       "mathematica": {
         "type": "stdio",
         "command": "uv",
         "args": ["--directory", "/path/to/mathematica-mcp", "run", "mathematica-mcp-full"]
       }
     }
   }
   

📖 See the Installation Guide for troubleshooting and advanced setup.

---

Why use it?

For Students & Researchers

• Symbolic Math: "Integrate Sin[x]^4 Cos[x]^2, simplify it, and show the steps."
• Visualization: "Render a 3D Sombrero surface and export as SVG."

For Developers

• Debugging: "Trace the evaluation of MyCustomFunction[x]."
• Parsing: "Extract only the Wolfram code from this .nb file."

For Data Scientists

• Real Data: "Compare GDP for US, China, and Japan."
• Import: "Load data.csv and plot the distribution."

---

Documentation

• Technical Reference: Deep dive into architecture, tools, and configuration.

---

License

MIT License