KosmoKrator

documents

Mindee MCP Integration for Codex

Connect Mindee to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

5 functions 1 read 4 write API key auth
Submit Mindee feedback View package source

Connect Mindee to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Mindee MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-mindee": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=mindee",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=mindee --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Mindee instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Mindee Tools Visible to Codex

Codex sees stable MCP tool names generated from the Mindee integration catalog.

MCP toolSource functionTypeDescription
integration__mindee__mindee_parse_invoice mindee.mindee_parse_invoice Write Parse an invoice document (PDF or image) and extract structured data including supplier, line items, totals, dates, and tax details.
integration__mindee__mindee_parse_receipt mindee.mindee_parse_receipt Write Parse an expense receipt (PDF or image) and extract structured data including merchant, line items, totals, dates, and category.
integration__mindee__mindee_parse_passport mindee.mindee_parse_passport Write Parse a passport document (PDF or image) and extract structured data including full name, date of birth, nationality, passport number, and expiry date.
integration__mindee__mindee_parse_custom mindee.mindee_parse_custom Write Parse a document using a custom Mindee API endpoint. Requires an endpoint_id from your custom model trained in the Mindee API builder.
integration__mindee__mindee_get_current_user mindee.mindee_get_current_user Read Get the current authenticated Mindee user's account information — useful for verifying credentials and connection.

Related Mindee Pages

Mindee CLIUse direct JSON commands instead of MCP discovery. Mindee MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.