inoyu-mcp-unomi-server MCP Server

A Model Context Protocol server enabling Claude to maintain user context through Apache Unomi profile management.

Local serverstdioApache-2.0

What is the inoyu-mcp-unomi-server MCP Server?

inoyu-mcp-unomi-server is an MCP project maintained in the sergehuber/inoyu-mcp-unomi-server repository. The maintainer describes its purpose as “A Model Context Protocol server enabling Claude to maintain user context through Apache Unomi profile management”. Read the project documentation for the complete scope.

Installation

The documented npm package is @inoyu/mcp-unomi-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares UNOMI_BASE_URL, UNOMI_USERNAME, UNOMI_PASSWORD, UNOMI_PROFILE_ID, UNOMI_KEY, UNOMI_EMAIL, UNOMI_SOURCE_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_my_profile	Get your profile using environment variables
requireSegments	Include segment information
requireScores	Include scoring information
update_my_profile	Update properties of your profile
Example	json
get_profile	Retrieve a specific profile by ID
search_profiles	Search for profiles
create_scope	Create a new Unomi scope
get_tenant_info	Get information about the current tenant (V3 only)

How to install the inoyu-mcp-unomi-server MCP Server

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": [
        "@inoyu/mcp-unomi-server"
      ],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_USERNAME": "your-username",
        "UNOMI_PASSWORD": "YOUR_UNOMI_PASSWORD",
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "YOUR_UNOMI_KEY",
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
UNOMI_BASE_URL	Declared in the maintainer’s client configuration.	Check documentation
UNOMI_USERNAME	Declared in the maintainer’s client configuration.	Yes
UNOMI_PASSWORD	Declared in the maintainer’s client configuration.	Yes
UNOMI_PROFILE_ID	Declared in the maintainer’s client configuration.	Check documentation
UNOMI_KEY	Declared in the maintainer’s client configuration.	Yes
UNOMI_EMAIL	Declared in the maintainer’s client configuration.	Check documentation
UNOMI_SOURCE_ID	Declared in the maintainer’s client configuration.	Check documentation