A comprehensive Model Context Protocol (MCP) server for managing Snipe-IT inventory systems. This server enables AI assistants to perform full CRUD operations across your entire Snipe-IT instance with 39 tools covering all major API endpoints.

• Full CRUD Operations: Create, read, update, delete, and search assets with enhanced filtering
• Barcode/Serial Lookup: Direct bytag/byserial API endpoints for reliable barcode scanning
• Asset Operations: Checkout, checkin, audit, and restore assets
• Checkout Requests: Submit and cancel checkout requests for requestable assets
• File Attachments: Upload, download, list, and delete asset files
• Label Generation: Generate printable PDF labels
• Maintenance Tracking: Create and manage maintenance records
• License Associations: View licenses assigned to assets

• Consumables: Complete management of consumable items
• Components: Manage components with checkout/checkin to assets
• Accessories: Track accessories with checkout/checkin to users

• Users: Full user management including restore and current user endpoint
• User Assets: View all items checked out to a user (assets, accessories, licenses, consumables, EULAs)
• Two-Factor Auth: Reset user 2FA (admin function)
• Companies: Multi-tenant company management
• Departments: Organizational department management
• Groups: Permission group management

• Categories: Manage categories for all item types
• Manufacturers: Track manufacturer information
• Models: Define asset models with depreciation, custom fields, and file attachments
• Status Labels: Configure asset statuses with asset listing
• Locations: Manage physical locations with hierarchy, asset/user queries
• Suppliers: Track supplier information
• Depreciations: Define depreciation schedules

• Fields: Create and manage custom field definitions
• Fieldsets: Group custom fields for assignment to models with field reordering
• Field Association: Associate/disassociate fields with fieldsets

• License Management: Full CRUD for software licenses
• Seat Assignments: Checkout/checkin license seats
• License Files: Manage license documentation

• Activity Logs: Query all activity history
• Item Activity: Get activity for specific items
• Status Summary: Asset counts grouped by status label
• Audit Tracking: Track assets due/overdue for audit

• CSV Imports: Full import workflow (upload, map columns, process)
• System Info: Get Snipe-IT version information
• Backups: List and download database backups
• LDAP Operations: LDAP sync and connection testing

• Python 3.11+
• UV package manager
• Snipe-IT instance with API access
• API token with appropriate permissions

git clone https://github.com/jameshgordy/snipeit-mcp.git
cd snipeit-mcp

uv sync

Create a .env file:

SNIPEIT_URL=https://your-snipeit-instance.com
SNIPEIT_TOKEN=your-api-token-here
SNIPEIT_ALLOWED_TOOLS=manage_assets,system_info  # Optional: restrict exposed tools

Getting an API Token:

1. Log in to your Snipe-IT instance
2. Navigate to your user profile (top right menu)
3. Go to "Manage API Keys" or "Personal Access Tokens"
4. Generate a new token with required permissions

Add to your MCP configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A: Install directly from GitHub (no clone required)

{
  "mcpServers": {
    "snipeit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jameshgordy/snipeit-mcp",
        "snipeit-mcp"
      ],
      "env": {
        "SNIPEIT_URL": "https://your-snipeit-instance.com",
        "SNIPEIT_TOKEN": "your-api-token-here"
      }
    }
  }
}

Option B: Run from a local clone

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

Add to your Cursor MCP settings with the same configuration format as above.

{
  "action": "create",
  "asset_data": {
    "status_id": 1,
    "model_id": 5,
    "asset_tag": "LAP-001",
    "name": "MacBook Pro 14",
    "serial": "C02X12345"
  }
}

{
  "action": "create",
  "user_data": {
    "first_name": "John",
    "last_name": "Doe",
    "username": "jdoe",
    "email": "[email protected]",
    "password": "securepassword",
    "password_confirmation": "securepassword",
    "department_id": 1
  }
}

{
  "user_id": 123,
  "asset_type": "all"
}

{
  "action": "checkout",
  "component_id": 45,
  "checkout_data": {
    "assigned_to": 123,
    "assigned_qty": 2,
    "note": "RAM upgrade"
  }
}

{
  "action": "list",
  "action_type": "checkout",
  "limit": 50
}

{
  "action": "create",
  "field_data": {
    "name": "MAC Address",
    "element": "text",
    "format": "MAC"
  }
}

{
  "action": "associate",
  "field_id": 5,
  "fieldset_id": 1,
  "required": true,
  "order": 1
}

All tools return structured JSON responses:

Success:

{
  "success": true,
  "action": "create",
  "asset": {
    "id": 123,
    "asset_tag": "LAP-001",
    "name": "MacBook Pro 14"
  }
}

Error:

{
  "success": false,
  "error": "Asset not found: Asset with tag LAP-999 not found."
}

Built with:

• FastMCP: Python framework for MCP servers
• snipeit-python-api: Snipe-IT API client
• Pydantic: Data validation and type safety

• Verify your Snipe-IT URL includes the protocol (https://)
• Check that your API token is valid and not expired
• Ensure the token has appropriate permissions for the operations

• Verify network connectivity to your Snipe-IT instance
• Check for any firewall or proxy restrictions
• Ensure the Snipe-IT instance is running

• Check that required fields are provided (e.g., status_id and model_id for assets)
• Verify that referenced IDs exist (categories, models, locations, etc.)
• Review the tool documentation for required parameters

MIT License

Contributions welcome! Please open an issue or submit a pull request.