Inoyu MCP Unomi

Inoyu MCP Unomi server manages user profiles and context for Claude via Apache Unomi, enabling personalized and consistent interactions.

Connections & Capabilities

Connects To

GitHub

Capabilities

readwrite

Quickstart

Install

npm install
```

Config

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_VERSION": "3", // Use "2" for Unomi V2, "3" for Unomi V3 (default)
        "UNOMI_USERNAME": "your-username", // Required for V2, fallback for V3
        "UNOMI_PASSWORD": "your-password", // Required for V2, fallback for V3
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "your-unomi-key", // Required for V2 only
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop",
        "UNOMI_TENANT_ID": "your-tenant-id", // Required for V3
        "UNOMI_PUBLIC_KEY": "your-public-key", // Required for V3
        "UNOMI_PRIVATE_KEY": "your-private-key" // Required for V3
      }
    }
  }
}

Exposed MCP Tools (9)

safe

get_my_profile

Retrieves the user's profile information using environment variables or email lookup.

Read-only operation; retrieves profile data.

moderate

update_my_profile

Updates properties of the user's profile with provided key-value pairs.

Modifies profile properties; potential for data corruption if not validated.

safe

get_profile

Retrieves a specific profile by its ID.

Read-only operation; retrieves profile data.

safe

search_profiles

Searches for profiles based on a query string across first name, last name, and email.

Read-only operation; searches profile data.

moderate

create_scope

Creates a new Unomi scope with a given identifier, name, and description.

Creates a new scope which can affect context isolation.

safe

get_tenant_info

Retrieves information about the current tenant, including version and key status (V3 only).

Read-only operation; retrieves tenant information.

moderate

update_consent

Updates a user's consent status using the modifyConsent event.

Modifies user consent status; potential for privacy implications.

safe

get_consent

Retrieves specific consent information for a profile.

Read-only operation; retrieves consent data.

safe

list_consents

Lists all consents for a profile with optional filtering.

Read-only operation; lists consent data.

Safety Assessment

This MCP server offers useful profile management features but requires careful configuration of environment variables and CORS to prevent unauthorized access. It's relatively safe for read operations, but profile updates and consent modifications should be performed with caution.

Profile access is controlled through email lookup or profile ID.
Consent management tools provide GDPR compliance.
Automatic scope management ensures context isolation.
Supports both Unomi V2 and V3 with appropriate authentication.

Requires environment variables for Unomi credentials, posing a risk if misconfigured.
Profile updates and consent modifications can have unintended consequences if not carefully managed.
Improper CORS configuration can expose Unomi to unauthorized access.
Lack of input validation on profile properties could lead to data integrity issues.
The server has write access to profile data.