What is itemit-mcp?

itemit-mcp is an MCP (Model Context Protocol) server designed to bridge the itemit asset management API with the MCP ecosystem, enabling programmatic asset tracking and developed by uminai MCP.

How to use itemit-mcp?

1. Obtain itemit API credentials (API key, user ID, token, workspace ID).
2. Clone the repository and install dependencies with npm install
3. Build the project with npm run build
4. Configure your MCP client with the provided environment variables and server settings.
5. Use available MCP tools (e.g., search-item-by-name) via your MCP client.

Key features of itemit-mcp?

• Search, create, and manage items/locations in itemit via MCP.
• Integration with MCP-enabled systems for asset management.
• Supports tools like get-location-by-name, create-item, get-reminders.
• Structured JSON/structured text responses for seamless integration.

Use cases of itemit-mcp?

1. Automating asset tracking workflows across MCP-compatible platforms.
2. Integrating itemit asset data into custom MCP applications.
3. Building MCP-driven asset management dashboards.
4. Enabling MCP tools to interact with itemit’s item/location data.

FAQ from itemit-mcp?

• What prerequisites are required?

Node.js (v16+, an MCP Client, and an itemit account with API credentials.

• How do I set up environment variables?

Set them in .env or your MCP client configuration (e.g., ITEMIT_API_KEY).

• What MCP tools are available?

Tools include search-item-by-name, create-item, get-reminders, etc.

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.

---