KosmoKrator

productivity

Kintone MCP Integration for OpenAI Agents SDK

Connect Kintone to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Kintone feedback View package source

Connect Kintone to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Kintone MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Kintone 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.

Kintone Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Kintone integration catalog.

MCP toolSource functionTypeDescription
integration__kintone__kintone_list_records kintone.kintone_list_records Read Retrieve records from a Kintone app. Supports filtering with a query string, selecting specific fields, and pagination with limit/offset. Use this to search and list data stored in any Kintone app.
integration__kintone__kintone_get_record kintone.kintone_get_record Read Retrieve a single record from a Kintone app by its record ID. Returns all field values for the record.
integration__kintone__kintone_create_record kintone.kintone_create_record Write Create a new record in a Kintone app. The record parameter is an object keyed by field codes, each containing a "value" property (e.g., {"Title": {"value": "Hello"}, "Number": {"value": 42}}).
integration__kintone__kintone_list_apps kintone.kintone_list_apps Read List available Kintone apps. Returns app IDs, names, and descriptions to help discover which apps are accessible.
integration__kintone__kintone_get_app kintone.kintone_get_app Read Get details of a specific Kintone app, including its name, description, and settings.
integration__kintone__kintone_list_spaces kintone.kintone_list_spaces Read List Kintone spaces. Spaces are collaborative workspaces that contain apps, threads, and other resources.
integration__kintone__kintone_get_current_user kintone.kintone_get_current_user Read Get the profile of the currently authenticated Kintone user, including name, email, and user settings.

Related Kintone Pages

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