Itemit MCP Server
About
itemit-mcp is an MCP server for asset tracking, providing a bridge between the itemit asset management API and the Model Context Protocol (MCP) ecosystem.
Details
- Author
- umin-ai
- Downloads
- 211
- Categories
- Productivity, API, Developer Tools
Jump to
- Search for items by name in itemit.
- Create items with name, description, and serial number.
- Get a list of items from itemit.
- Get reminders from itemit.
- Search for locations by name with item list.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Itemit MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies with npm install, build with npm run build, then configure your MCP client to run the built script via stdio, providing the required environment variables: ITEMIT_API_KEY, ITEMIT_USER_ID, ITEMIT_USER_TOKEN, and ITEMIT_WORKSPACE_ID. Use your MCP client to invoke the exposed tools.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"itemit mcp server": {
"itemit-mcp": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
"/<path>/<user>/Documents/itemit-mcp/build/index.js"
],
"env": {
"ITEMIT_API_KEY": "<YOUR_API_KEY>",
"ITEMIT_USER_ID": "<YOUR_USER_ID>",
"ITEMIT_USER_TOKEN": "<YOUR_USER_TOKEN>",
"ITEMIT_WORKSPACE_ID": "<YOUR_WORKSPACE_ID>"
}
}
}
}
}McpServers
{
"itemit-mcp": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
"/<path>/<user>/Documents/itemit-mcp/build/index.js"
],
"env": {
"ITEMIT_API_KEY": "<YOUR_API_KEY>",
"ITEMIT_USER_ID": "<YOUR_USER_ID>",
"ITEMIT_USER_TOKEN": "<YOUR_USER_TOKEN>",
"ITEMIT_WORKSPACE_ID": "<YOUR_WORKSPACE_ID>"
}
}
}itemit-mcp
itemit-mcp is an MCP server for asset tracking, providing a bridge between the itemit asset management API and the Model Context Protocol (MCP) ecosystem.
Built and maintained by the uminai MCP team.
---
Table of Contents
- Overview
- Prerequisites
- Obtaining itemit API Credentials
- Installation & Build
- MCP Client Configuration
- Environment Variables
- Available MCP Tools
- Example Usage
- Response Format
- Credits & Further Resources
---
Overview
itemit-mcp exposes a set of tools for interacting with the itemit asset management platform via the MCP protocol. It allows you to search, create, and manage assets and locations programmatically, making it easy to integrate itemit with other MCP-enabled systems. Following tools available:
- Get List of items
- Get item by name search
- Create item
- Location Search (With item list on it)
---
Prerequisites
- Node.js (v16+ recommended)
- Access to an itemit account (to obtain API credentials)
- MCP Client (see uminai MCP for more info)
---
Obtaining itemit API Credentials
To use this MCP server, you need API credentials from itemit:
- ITEMIT_API_KEY
- ITEMIT_USER_ID
- ITEMIT_USER_TOKEN
- ITEMIT_WORKSPACE_ID
You can obtain these by signing up or logging in at itemit and following their API documentation or contacting their support.
---
Installation & Build
Clone this repository and install dependencies:
npm install
Build the project:
npm run build
---
MCP Client Configuration
Add the following to your MCP Client configuration (e.g., cline_mcp_settings.json):
{
"mcpServers": {
"itemit-mcp": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "node",
"args": [
"/Users/<user>/Documents/itemit-mcp/build/index.js"
],
"env": {
"ITEMIT_API_KEY": "<YOUR_API_KEY>",
"ITEMIT_USER_ID": "<YOUR_USER_ID>",
"ITEMIT_USER_TOKEN": "<YOUR_USER_TOKEN>",
"ITEMIT_WORKSPACE_ID": "<YOUR_WORKSPACE_ID>"
}
}
}
}
Replace the placeholder values with your actual itemit credentials.
---
Environment Variables
- ITEMIT_API_KEY: Your itemit API key
- ITEMIT_USER_ID: Your itemit user ID
- ITEMIT_USER_TOKEN: Your itemit user token
- ITEMIT_WORKSPACE_ID: Your itemit workspace ID
These can be set in your environment or in a .env file.
---
Available MCP Tools
1. get-location-by-name
- Description: Get locations by name in itemit.
- Parameters:
- name (string, required): Name of the location to search for
- limit (integer, optional): Number of locations to retrieve (default 25, max 100)
- skip (integer, optional): Number of locations to skip (default 0)
- Example:
{
"name": "Warehouse"
}
---
2. search-item-by-name
- Description: Search for items by name in itemit.
- Parameters:
- name (string, required): Name of the item to search for
- size (integer, optional): Number of items to retrieve (default 15, max 100)
- page (integer, optional): Page number (default 1)
- Example:
{
"name": "Laptop"
}
---
3. create-item
- Description: Create an item in itemit.
- Parameters:
- name (string, required): Name of the item
- description (string, required): Description of the item
- serial (string, required): Serial number of the item
- Example:
{
"name": "Projector",
"description": "Epson HD Projector",
"serial": "SN123456"
}
---
4. get-reminders
- Description: Get reminders from itemit.
- Parameters: None
---
5. get-items
- Description: Get items from itemit.
- Parameters:
- size (integer, optional): Number of items to retrieve (default 15, max 100)
- Example:
{
"size": 10
}
---
Example Usage
Use your MCP Client to invoke these tools. For example, to search for an item:
{
"tool": "search-item-by-name",
"arguments": {
"name": "Laptop"
}
}
---
Response Format
All responses are returned as structured text or JSON, matching the itemit API's data model. For example, a successful search might return:
{
"content": [
{
"type": "text",
"text": "Search results for \"Laptop\" (size=15):\n1. Dell XPS 13 (ID: 1234)\n2. MacBook Pro (ID: 5678)\n..."
}
]
}
---
Credits & Further Resources
- Project by the uminai MCP team.
- Powered by itemit.
- Discover more MCP servers and integrations at mcp.umin.ai.
---
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
