Snipe-IT MCP Server
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.
Features
Asset Management
- 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
Inventory Tracking
- Consumables: Complete management of consumable items
- Components: Manage components with checkout/checkin to assets
- Accessories: Track accessories with checkout/checkin to users
Users & Organization
- 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
System Configuration
- 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
Custom Fields
- 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
Licensing
- License Management: Full CRUD for software licenses
- Seat Assignments: Checkout/checkin license seats
- License Files: Manage license documentation
Reporting & Auditing
- 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
Import & System Administration
- 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
Requirements
- Python 3.11+
- UV package manager
- Snipe-IT instance with API access
- API token with appropriate permissions
Installation
1. Clone the repository
git clone https://github.com/jameshgordy/snipeit-mcp.git
cd snipeit-mcp
2. Install dependencies
uv sync
3. Configure environment variables
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
| Variable | Required | Description |
|----------|----------|-------------|
| SNIPEIT_URL | Yes | Your Snipe-IT instance URL |
| SNIPEIT_TOKEN | Yes | API token for authentication |
| SNIPEIT_ALLOWED_TOOLS | No | Comma-separated list of tool names to expose. If unset, all tools are available. |
Getting an API Token:
- Log in to your Snipe-IT instance
- Navigate to your user profile (top right menu)
- Go to "Manage API
... View full README on GitHub
