How do I use inventree-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@inventree-mcp list all parts in category Electronics" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

InvenTree MCP Server

MCP server for InvenTree inventory management. Provides 12 parameterized tools covering 117 operations for parts, stock, build orders, purchase/sales/return orders, companies, barcodes, labels, reports, attachments, and system administration.

Requirements

Python 3.11+
uv (recommended) or pip
An InvenTree instance with API access enabled
An API token (generate from InvenTree > Settings > API Tokens)

Setup

# Clone the repository
git clone https://github.com/puran-water/inventree-mcp.git
cd inventree-mcp

# Copy the example environment file and fill in your values
cp .env.example .env

# Install dependencies
uv sync

Edit .env with your InvenTree instance URL and API token:

INVENTREE_URL=https://your-inventree-instance.example.com
INVENTREE_TOKEN=your-api-token-here

Usage

STDIO mode (default)

uv run python server.py

SSE mode (HTTP transport)

uv run python server.py sse --port 3074

Claude Desktop / MCP client configuration

Add to your MCP client config (e.g. ~/.claude/mcp.json):

{
  "mcpServers": {
    "inventree-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/inventree-mcp", "python", "server.py"],
      "env": {
        "INVENTREE_URL": "https://your-inventree-instance.example.com",
        "INVENTREE_TOKEN": "your-api-token-here"
      }
    }
  }
}

Or for SSE transport:

{
  "mcpServers": {
    "inventree-mcp": {
      "url": "http://localhost:3074/sse"
    }
  }
}

Tools

Each tool uses a parameterized operation field to select the specific action.

Tool	Operations	Description
`part`	21	Part & category management (list, get, create, update, delete, BOM, suppliers, parameters)
`stock`	16	Stock item & location management (list, get, create, transfer, count, add, remove)
`build_order`	9	Manufacturing build orders (list, get, create, update, allocate, complete, cancel)
`purchase_order`	12	Purchase order lifecycle (list, get, create, update, issue, receive, complete)
`sales_order`	14	Sales order lifecycle (list, get, create, shipments, allocations)
`return_order`	8	Return order management
`company`	12	Suppliers, manufacturers, customers, contacts, addresses
`barcode`	4	Barcode scan, assign, unassign, lookup
`label`	5	Label template listing and printing
`report`	3	Report template listing and generation
`attachment`	5	File attachments on any object (upload, download, delete)
`system`	8	Health, version, settings, users, groups, currencies

Architecture

server.py — FastMCP server with 12 parameterized tools and dual transport (STDIO/SSE)
client.py — Async adapter wrapping the official inventree-python library via asyncio.to_thread() with a semaphore for concurrency control

The inventree-python library is synchronous (requests-based). All calls are offloaded to threads to maintain async compatibility with the MCP framework.