Snipe-IT Copilot MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Snipe-IT Copilot MCP check out the MacBook with asset tag MBP-1024 to sarah@company.com"
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.
Snipe-IT Copilot MCP
A production-oriented Model Context Protocol server for Snipe-IT, designed specifically for Microsoft Copilot Studio generative orchestration.
This is a greenfield implementation. It talks directly to Snipe-IT with asynchronous httpx, exposes exactly 29 semantic tools, uses Streamable HTTP at /mcp, and declares inline Copilot-safe input/output schemas. It does not depend on a third-party Snipe-IT Python wrapper.
Why this server exists
Generic CRUD tools and loosely typed dict outputs make it difficult for an orchestrator to know which fields actually exist. This server makes important inventory data visible in the MCP contract itself. In particular, asset responses explicitly advertise asset_tag, serial, model_name, model_number, manufacturer, status, assignment, and location. user_inventory reuses the same asset normalizer and schema.
The public contract avoids $ref, $defs, definitions, multi-type type arrays, and ambiguous schema unions that Copilot Studio currently does not support reliably.
Related MCP server: mcp-m365-mgmt
Highlights
29 tools, grouped by domain and safety class.
Only
delete_resourcecan issue HTTPDELETE.Direct asynchronous Snipe-IT REST calls with bounded requests/responses.
Shared service-account token and per-user Snipe-IT Passport OAuth modes.
HTTP 200 plus Snipe-IT application-error detection.
Exact tag, serial, email, username, and employee-number resolution.
Global search, per-field filters, advanced filter JSON, and custom-field name resolution.
Rich, defensive normalizers that preserve unknown values as
extra_fieldsname/value arrays.Limit/offset and page/per-page pagination normalized into predictable envelopes.
Structured JSON logs with credential redaction.
Health (
/health) and readiness (/ready) endpoints.Docker, systemd, nginx, idempotent setup/update scripts, schema linting, and tests.
Architecture
Copilot Studio -- Streamable HTTP /mcp --> FastMCP 3
|
explicit schemas + 29 semantic tools
|
resolvers -> normalizers -> async httpx client
|
Snipe-IT /api/v1See docs/ARCHITECTURE.md, docs/SECURITY.md, docs/FEATURE_PARITY.md, and docs/SNIPEIT_API_COVERAGE.md.
Requirements
Python 3.11 or newer
uvA reasonably current Snipe-IT release with API access
HTTPS with a publicly trusted or explicitly configured enterprise CA for production
The API audit was refreshed against Snipe-IT v8.6.2/current source on 2026-08-07. Optional endpoints remain registered and fail cleanly when an older connected server does not support them.
Quick start
For a complete installation walkthrough covering credentials, local development, Docker, Linux/systemd, HTTPS, and the Copilot Studio connection, see docs/INSTALLATION.md.
cp .env.example .env
# Edit .env first; do not commit it.
uv sync --frozen
set -a; . ./.env; set +a
mkdir -p .tmp/fastmcp
FASTMCP_HOME="$PWD/.tmp/fastmcp" uv run --frozen python -m snipeit_copilot_mcpThe production MCP URL is:
https://your-mcp-host.example/mcpFor local stdio development only:
MCP_TRANSPORT=stdio uv run python -m snipeit_copilot_mcpAuthentication
Shared API-token mode
Configure SNIPEIT_URL, SNIPEIT_TOKEN, and—in HTTP mode—a separate SNIPEIT_MCP_TOKEN of at least 32 characters. Copilot sends the latter as the MCP server bearer/API key. Snipe-IT sees only the service account represented by SNIPEIT_TOKEN; its permissions remain authoritative.
Never reuse the privileged upstream token as the inbound MCP credential.
Per-user OAuth mode
Create a Laravel Passport OAuth client in Snipe-IT with redirect URI:
https://your-mcp-host.example/auth/callbackConfigure all SNIPEIT_OAUTH_* values, the public SNIPEIT_MCP_BASE_URL, an explicit Copilot callback allowlist, and a durable SNIPEIT_OAUTH_JWT_SIGNING_KEY. FastMCP exposes OAuth discovery/DCR-compatible proxy endpoints and forwards interactive login to Snipe-IT. Each tool call uses the authenticated user's upstream token, so their Snipe-IT permissions are preserved.
Keep FASTMCP_HOME on persistent, mode-restricted storage. For a horizontally scaled deployment, use a supported shared encrypted storage backend instead of local state.
Detailed configuration is in docs/COPILOT_STUDIO_SETUP.md.
Tool overview
Tool | Purpose | Safety |
| Asset list/get/search/exact tag/exact serial/requestable catalog | Read-only |
| Asset create/update | Write, non-delete |
| Checkout/checkin/audit/restore | Write, non-delete |
| Attachment list/bounded download | Read-only |
| Bounded multipart upload | Write, non-delete |
| Generate label PDF | Read/generate |
| Maintenance records, notes, types, completion | Mixed, non-delete |
| Licences associated with an asset | Read-only |
| Request/cancel requestable asset | Write, non-delete |
| Accessories/components/consumables | Read-only |
| Inventory create/update | Write, non-delete |
| Inventory assignment/checkin | Write, non-delete |
| User lookup/current user | Read-only |
| Create/update/restore/explicit 2FA reset | High-impact write |
| All inventory assigned to one user | Read-only |
| Companies/departments/groups | Read-only |
| Organisation create/update | Write, non-delete |
| Reference/configuration and relationships | Read-only |
| Reference/configuration create/update | Write, non-delete |
| Fields/fieldsets/membership | Read-only |
| Field/fieldset writes and ordering | Write, non-delete |
| Licence search/get | Read-only |
| Licence create/update | Write, non-delete |
| Seat list/checkout/checkin/update | Mixed, non-delete |
| Activity/status/audit/depreciation reports | Read-only |
| Explicit staged CSV workflow | High-impact write |
| Version/backups | Read-only |
| Connection test or explicit sync | High-impact write |
| Confirmed deletion only | Destructive |
Tool filtering
Unset SNIPEIT_ALLOWED_TOOLS to expose all tools. Set an exact comma-separated allowlist to expose a least-privilege subset:
SNIPEIT_ALLOWED_TOOLS=assets_search,users_search,user_inventory,inventory_search,catalog_searchUnknown, blank, or incorrectly cased names fail startup.
Testing and validation
uv sync --extra test
uv run pytest --cov=snipeit_copilot_mcp --cov-report=term-missing
uv run python scripts/validate_copilot_schemas.pyIntegration tests require SNIPEIT_INTEGRATION_TESTS=true and separate test-instance credentials. Destructive integration tests additionally require SNIPEIT_INTEGRATION_ALLOW_DESTRUCTIVE=true; they never run by default.
Use MCP Inspector against the production transport:
npx @modelcontextprotocol/inspector http://127.0.0.1:8000/mcpDocker
docker build -t snipeit-copilot-mcp:1.0.0 .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 \
-e MCP_HOST=0.0.0.0 \
-v snipeit-mcp-state:/var/lib/snipeit-copilot-mcp \
snipeit-copilot-mcp:1.0.0Terminate TLS at a trusted reverse proxy. Do not publish plaintext port 8000 directly to the internet.
systemd deployment
sudo git clone YOUR_REPOSITORY_URL /opt/snipeit-copilot-mcp
cd /opt/snipeit-copilot-mcp
sudo ./scripts/setup.sh
sudoedit /etc/snipeit-copilot-mcp.env
sudo systemctl enable --now snipeit-copilot-mcp.service
curl http://127.0.0.1:8000/healthUpdate:
sudo /opt/snipeit-copilot-mcp/scripts/update.shThe installer creates a non-login, non-root service user; root-owned source and virtual environment; a persistent state directory; a mode-0640 environment file; a hardened unit; and automatic boot startup. TLS guidance and the nginx example are in deploy/.
Snipe-IT permissions
Tokens inherit the Snipe-IT user's permissions. Grant only the domains and actions the deployed allowlist needs. The MCP never retries alternative endpoints to bypass a 403 and returns permission_denied clearly.
Troubleshooting
401from the MCP boundary: verify Copilot's MCP API key/OAuth connection, not the upstream token.authentication_failed: verifySNIPEIT_TOKENor complete the per-user Passport login.permission_denied: adjust the Snipe-IT user's permissions; the MCP will not bypass them.HTML instead of JSON: verify the Snipe-IT URL and reverse proxy and ensure API requests retain
Accept: application/json.Missing tools: check the exact
SNIPEIT_ALLOWED_TOOLSallowlist and run the schema linter.TLS failure: install the correct CA and set
SNIPEIT_CA_BUNDLE; do not disable verification in production.Optional endpoint unavailable: inspect
system_read(action_name="version")and the API coverage matrix.
Upgrade strategy
The client ignores unknown response fields, normalizers tolerate missing nested objects, and useful unknown values are retained as bounded extra_fields. Public schemas remain stable. Before upgrading FastMCP or Snipe-IT, run the full suite, schema linter, MCP Inspector tools/list, and representative mocked/safe integration calls.
Acknowledgements
This project was inspired by jameshgordy/snipeit-mcp. The feature parity guide maps its capabilities to this Copilot Studio implementation.
OpenAI Codex assisted with the design, implementation, security review, testing, and documentation of this project.
License
MIT. See LICENSE.
Available Tools
29 toolsasset_labelsARead-onlyIdempotent
Generate a bounded printable Snipe-IT asset-label PDF for explicitly supplied asset IDs. Returns file metadata and base64 content suitable for a client to save. Do not use for ordinary asset lookup or for unbounded label generation.
Inputs: asset_ids_json (required), label_name. Returns: item, message, success, error_code, +1 more
asset_licensesBRead-onlyIdempotent
Read software licences associated with one asset, resolving an exact asset tag or serial when needed. Returns product keys only when Snipe-IT and the caller's permissions expose them. This tool is read-only.
Inputs: limit, offset, serial, asset_id, +1 more. Returns: page, count, items, limit, +10 more
asset_lifecycleA
Checkout, checkin, audit, or restore one Snipe-IT asset after deterministically resolving its ID. Human identifiers and exact user email are accepted when unambiguous. Use only when the user explicitly requests the lifecycle action. This tool never deletes an asset.
Inputs: action_name (required), note, serial, asset_id, +7 more. Returns: item, message, success, error_code, +1 more
asset_maintenanceB
List, retrieve, create, update, complete, or add/list notes for Snipe-IT asset maintenance, and list maintenance types. Use for maintenance records only. The tool cannot delete maintenance records or types; deletion is isolated in delete_resource.
Inputs: action_name (required), cost, limit, notes, +8 more. Returns: page, count, items, limit, +10 more
asset_requestsA
Submit or cancel the authenticated user's request for a requestable asset. Use only when the user explicitly asks to request or cancel a request. This does not approve requests, checkout assets, or delete data.
Inputs: action_name (required), note, serial, asset_id, +2 more. Returns: item, message, success, error_code, +1 more
assets_searchARead-onlyIdempotent
Search and retrieve Snipe-IT hardware by ID, exact asset tag, exact serial, text, structured fields, custom fields, or the authenticated user's requestable catalog. Use for every read-only asset question. Returns explicit asset_tag, serial, model_name, model_number, manufacturer, status, assignment, location, dates, cost, and stable custom_fields. Do not use for writes, lifecycle actions, or deletion.
Inputs: action_name (required), page, sort, limit, +19 more. Returns: page, count, items, limit, +10 more
assets_writeAIdempotent
Create or update a Snipe-IT hardware asset using explicit common fields and optional custom fields. Use only for an explicit create or update request. This tool cannot delete, checkout, checkin, audit, or restore assets. Returns the normalized asset when the backend includes it.
Inputs: action_name (required), name, notes, serial, +14 more. Returns: item, message, success, error_code, +1 more
catalog_searchCRead-onlyIdempotent
Read Snipe-IT categories, manufacturers, models, status labels, locations, suppliers, depreciations, predefined kits, and maintenance types. Relationship actions assets_by_model, assets_by_status, assets_at_location, and users_at_location return rich records without hiding model information. This tool is read-only.
Inputs: catalog_type (required), sort, limit, order, +5 more. Returns: page, count, items, limit, +10 more
catalog_writeBIdempotent
Create or update supported Snipe-IT catalog records with explicit model, status, hierarchy, contact, depreciation, and type fields. Use for normal requested configuration writes. This tool has no delete action; all catalog deletion goes through delete_resource.
Inputs: action_name (required), catalog_type (required), url, city, +22 more. Returns: item, message, success, error_code, +1 more
custom_fields_searchARead-onlyIdempotent
Read/search custom fields, fieldsets, db_column identifiers, validation metadata, and fieldset membership. Use resource_type=field or fieldset. Dynamic values are represented through stable named properties and extra_fields arrays. This tool is read-only.
Inputs: limit, query, offset, item_id, +3 more. Returns: page, count, items, limit, +10 more
custom_fields_writeAIdempotent
Create/update fields and fieldsets, associate or disassociate a field, or reorder fields. Use explicit actions create_field, update_field, create_fieldset, update_fieldset, associate, disassociate, or reorder. This tool cannot delete fields or fieldsets.
Inputs: action_name (required), name, order, element, +9 more. Returns: item, message, success, error_code, +1 more
delete_resourceADestructive
Permanently or destructively remove confirmed Snipe-IT data. Use only for an explicit deletion request after the calling agent has retrieved and shown the exact target and received immediate user confirmation. For files, provide parent_id and file_id; for records, provide resource_id. This is the only MCP tool that can issue HTTP DELETE.
Inputs: resource_type (required), file_id, parent_id, resource_id. Returns: item, message, success, error_code, +1 more
files_readARead-onlyIdempotent
List attachment metadata or download one bounded attachment for a supported Snipe-IT parent. Download returns base64 only when the file fits max_inline_bytes; otherwise it reports metadata and content_truncated=true. This tool cannot upload or delete files.
Inputs: parent_id (required), action_name (required), parent_type (required), limit, +3 more. Returns: page, count, items, limit, +10 more
files_uploadA
Upload one explicitly supplied base64 attachment to a supported Snipe-IT parent. The filename is sanitized, upload size is bounded, and multipart encoding is used. This tool cannot read or delete attachments.
Inputs: filename (required), parent_id (required), parent_type (required), content_base64 (required), +2 more. Returns: item, message, success, error_code, +1 more
importsADestructive
Run the Snipe-IT CSV import workflow in explicit stages: list, get, upload, configure, validate, or process. Upload never processes a file; process runs only when action_name=process is explicitly requested. This tool cannot delete import files; use delete_resource after separate confirmation.
Inputs: action_name (required), limit, offset, filename, +5 more. Returns: page, count, items, limit, +10 more
inventory_lifecycleA
Checkout or check in accessories and components, or checkout consumables, using only assignment workflows officially exposed by Snipe-IT. Accessories accept user, asset, or location targets; components require an asset; consumables require a user. This tool never deletes records.
Inputs: item_id (required), action_name (required), inventory_type (required), note, +3 more. Returns: item, message, success, error_code, +1 more
inventory_searchBRead-onlyIdempotent
Read accessories, components, or consumables with normalized quantity, model, serial, manufacturer, location, company, supplier, purchase, and audit-safe extra fields. Set inventory_type to accessory, component, or consumable. Do not use for writes, assignments, or deletion.
Inputs: inventory_type (required), sort, limit, order, +9 more. Returns: page, count, items, limit, +10 more
inventory_writeAIdempotent
Create or update one accessory, component, or consumable using explicit fields. Use for ordinary inventory record writes after required IDs are known. This tool cannot assign, check in, check out, or delete inventory.
Inputs: action_name (required), inventory_type (required), qty, name, +13 more. Returns: item, message, success, error_code, +1 more
ldap_operationsADestructive
Test the configured Snipe-IT LDAP connection or explicitly synchronize LDAP users. action_name=test only checks connectivity; action_name=sync can materially change users and must be used only when synchronization was explicitly requested. This tool never infers sync from a test request.
Inputs: action_name (required). Returns: item, message, success, error_code, +1 more
license_seatsAIdempotent
List, checkout, checkin, or update licence seats. Checkout accepts exactly one user or asset target; checkin removes an assignment but never deletes the licence or seat. Use mutation actions only for explicit assignment requests.
Inputs: action_name (required), note, limit, offset, +4 more. Returns: page, count, items, limit, +10 more
licenses_searchBRead-onlyIdempotent
List, search, or retrieve software licences with explicit product_key, seat counts, category, manufacturer, supplier, company, purchase, expiry, maintenance, and reassignment fields. Product keys appear only when permissions allow. This tool is read-only.
Inputs: sort, limit, order, query, +8 more. Returns: page, count, items, limit, +10 more
licenses_writeAIdempotent
Create or update a Snipe-IT software licence. The public product_key input is deliberately translated to Snipe-IT's write-side serial field while reads expose product_key. Use only for explicit writes. This tool cannot delete licences or assign seats.
Inputs: action_name (required), name, notes, seats, +13 more. Returns: item, message, success, error_code, +1 more
organization_searchARead-onlyIdempotent
List, search, or retrieve Snipe-IT companies, departments, and permission groups. Use organization_type=company, department, or group. Returns stable identity/contact fields and safe extra field entries. This tool is read-only and cannot modify memberships or delete records.
Inputs: organization_type (required), limit, query, offset, +5 more. Returns: page, count, items, limit, +10 more
organization_writeAIdempotent
Create or update a Snipe-IT company, department, or group. Common relationship fields are explicit; group permissions can be supplied as a JSON object. Use only for requested writes. This tool cannot delete organisation records.
Inputs: action_name (required), organization_type (required), name, notes, +5 more. Returns: item, message, success, error_code, +1 more
reportsBRead-onlyIdempotent
Read Snipe-IT activity, one item's history, checkout/checkin history, status summaries, depreciation reports, and assets due, overdue, or due-or-overdue for audit. Results explicitly advertise both activity fields and rich asset identity fields. This tool never audits or changes records.
Inputs: action_name (required), limit, query, offset, +7 more. Returns: page, count, items, limit, +10 more
system_readARead-onlyIdempotent
Read Snipe-IT version/system information, list backups, or download one bounded backup. Version data supports capability diagnosis. Backup content is base64 only when it fits max_inline_bytes. This tool cannot change settings or delete backups.
Inputs: limit, offset, action_name, backup_filename, +1 more. Returns: item, count, items, message, +7 more
user_inventoryBRead-onlyIdempotent
Retrieve everything assigned to one unambiguously identified user in one call: rich assets, accessories, licences, consumables, and optional EULA/acceptance records. Assets use the same normalization as assets_search and explicitly include asset_tag, serial, model_name, model_number, manufacturer, status, and location. This tool is read-only.
Inputs: email, user_id, username, include_eulas. Returns: user, eulas, assets, message, +11 more
users_searchARead-onlyIdempotent
List, search, retrieve, or identify the current authenticated Snipe-IT user. Supports exact email, username, employee number and organisation filters, including deleted-user queries. Returns explicit identity, department, location, company, manager, flags, and inventory counts. Do not use for writes or deletion.
Inputs: sort, email, limit, order, +10 more. Returns: page, count, items, limit, +10 more
users_writeADestructive
Create, update, restore, or explicitly reset two-factor authentication for a Snipe-IT user. Use create/update/restore for requested administration; use reset_2fa only when the user explicitly asks for that high-impact security action. This tool cannot delete users.
Inputs: action_name (required), vip, email, notes, +15 more. Returns: item, message, success, error_code, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Tools are mostly split by resource and operation (search, write, lifecycle), with clear descriptions distinguishing read-only from mutation workflows. Minor overlaps exist, such as maintenance types being available in both catalog_search and asset_maintenance, and asset_licenses versus licenses_search, but these are well explained.
The set mostly follows a resource_action pattern (assets_search, users_write, licenses_search), making tools predictable. Minor deviations include bare nouns like imports and reports, singular/plural inconsistencies (asset_licenses vs licenses_search), and the verb_noun delete_resource.
At 29 tools, the surface is heavy for a single MCP server. The broad Snipe-IT domain justifies many resource-specific tools, and each tool groups multiple related operations, but the count still exceeds typical scoped sets and risks overwhelming selection.
Coverage is comprehensive: CRUD and lifecycle operations exist for assets, inventory, users, organizations, catalog data, custom fields, licenses, and license seats, with dedicated tools for files, imports, reports, system info, LDAP, and deletion. No obvious dead ends remain for standard Snipe-IT workflows.
Related MCP Connectors
Find assets, users and licenses, and check assets out or in in Snipe-IT.
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Connect your AI assistant to Revnu, your autonomous growth agent for outbound sales, SEO, content, social media and ads. Use this MCP connector to read leads and campaign results, review and approve queued work, hand jobs to your Revnu agent, and schedule recurring workflows from your AI chat. Supports Streamable HTTP and OAuth with permissions you choose at sign-in. Tools act on your connected Revnu account; write actions require explicit permissions. Learn more and connect at https://revnu.com/mcp.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Snipe-IT inventory systems through comprehensive asset and consumable operations. Supports creating, updating, tracking, and managing IT assets, consumables, maintenance records, file attachments, and generating labels.1-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and automation tools to manage Microsoft 365, Entra ID, and Intune resources through 32 tools for user/device/file management and infrastructure monitoring.8MIT
- AlicenseAqualityAmaintenanceEnables AI assistants to perform full CRUD operations on Snipe-IT inventory systems, managing assets, users, licenses, and more via 39 tools.4041MIT
snipe-it-mcpprivate
AlicenseNot gradedqualityCmaintenanceMCP server for Snipe-IT asset management, enabling users to read and manage IT assets, models, manufacturers, and related data through natural language. Designed to feed inventory into lifecycle audits.Apache 2.0