iDempiere MCP Server

This project implements a stateless Model Context Protocol (MCP) server for iDempiere ERP. It bridges the gap between AI assistants (like Google Antigravity, Anthropic Claude and Opencode) and iDempiere, enabling autonomous interaction with the ERP system to retrieve data, execute processes, and manage records.

Supported Protocol Versions

• 2025-11-25
• 2026-07-28

Tools Reference

• See MCP_TOOLS.md for the complete reference of all 88 MCP tools categorized by module.

Dependency

• iDempiere REST

To Test from Eclipse

• Import idempiere-rest project into your Eclipse workspace.
• Import the org.idempiere.mcp.server project into your Eclipse workspace.
• Create a launch configuration from your existing launch configuration and add both idempiere-rest and org.idempiere.mcp.server project.
• Run the launch configuration.

Authentication

• Create a new Rest Auth Token record. Copy the auto generated Token and use as HTTP Authorization Header (Bearer ``).
• Alternatively, use the create_auth_token tool to create authentication token and post as part of the request body (params.arguments["_authorization_bearer"]).

Testing with https://github.com/modelcontextprotocol/inspector

• npx @modelcontextprotocol/inspector
• use http://localhost:8080/mcp/ for Stremable HTTP Transport Type
• Authentication: Enable Authorization and enter Bearer ``

Testing with https://antigravity.google/download

• Edit ~/.gemini/config/mcp_config.json
• Streamable HTTP:

"mcpServers": {
  "idempiere-mcp-server": {
    "url": "http://localhost:8080/mcp/",
    "timeout": 30000,
    "trust": true,
    "headers": {
      "Authorization": "Bearer "
    }
  }
}

• Multiple token for different tenant:

"mcpServers": {
    "iDempiere-System": {
      "url": "http://localhost:8080/mcp/",
      "timeout": 30000,
      "trust": true,
      "headers": {
        "Authorization": "Bearer "
      }
    },
    "iDempiere-GardenWorld": {
      "url": "http://localhost:8080/mcp/",
      "timeout": 30000,
      "trust": true,
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

• Authentication with the create_auth_token tool:
  • Remove the “headers” property
  • Example: authenticate idempiere with GardenAdmin, GardenAdmin, clientId:GardenWorld, organizationId:HQ, roleId:GardenWorld Admin, warehouseId:HQ Warehouse
  • In subsequent request, specify using the return token as HTTP Authorization Bearer Token. This work as all method takes an optional argument _authorization_bearer as alternative to HTTP Authorization header.