LABSCO SUMMARY

Account credentials, not a scoped token.

Authentication is Basic — a Kintone username and password sit in the client config, which means the server can do whatever that account can do, in every app that account can see, including deletes. If that is a full-access account, scope it down before wiring this in: a dedicated Kintone user with permissions on only the apps you want reachable is the difference between a query tool and a standing risk. What you get in exchange is direct: the apps, their field definitions, and records you can filter and change from a conversation.

What it is

A lightweight Python MCP server for Kintone, Cybozu's business-application platform. It authenticates with Basic Authentication against your subdomain, lists the apps your account can see, reads their form fields, queries records with filtering and pagination, and performs create, read, update and delete on them.

What you get

The Kintone apps your account has permission to see, listed
The form fields of a given app, so records can be addressed by their real field names
Record queries with filtering and pagination
Create, read, update and delete operations on records
Input validation on the way through, and credentials read from the environment rather than hard-coded

Requirements

Python 3.10 or higher and a Kintone account. Three environment variables: KINTONE_SUBDOMAIN (the part before the cybozu.com domain), KINTONE_USERNAME and KINTONE_PASSWORD. pip install mcp-kintone-lite, or let the client run it directly with uvx --from mcp-kintone-lite mcp-kintone-lite, which is what the documented Claude Desktop entry does. The package is mcp-kintone-lite 0.1.0; a checkout plus uv sync or Poetry is the development path.

Setup effort

One command plus credentials — uvx --from mcp-kintone-lite mcp-kintone-lite, then supply credentials

See installation options

USE CASES

01

Asking what is in a Kintone app

List the apps the account can see, read one app's fields, then query its records with a filter.

02

Updating records without opening Kintone

Find the record from a description and change the fields that need changing, in the conversation.

03

Pulling Kintone data into other work

Query records with filtering and pagination and use the result in the document or analysis you are already writing.

04

Checking what fields an app actually has

Read the form definition before writing anything that depends on field names.

BEFORE YOU INSTALL

What to know first

Requires

uvx on PATH
Python 3.10 or later
KINTONE_SUBDOMAIN in your environment
KINTONE_USERNAME in your environment
KINTONE_PASSWORD in your environment

Where it runs

The documented client runs the server on your machine.

INSTALLATION

Connect your client

Server setup

TERMINAL

uvx --from mcp-kintone-lite mcp-kintone-lite

MCP Clients

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "kintone-lite": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-kintone-lite",
        "mcp-kintone-lite"
      ],
      "env": {
        "KINTONE_SUBDOMAIN": "<YOUR_KINTONE_SUBDOMAIN>",
        "KINTONE_USERNAME": "<YOUR_KINTONE_USERNAME>",
        "KINTONE_PASSWORD": "<YOUR_KINTONE_PASSWORD>"
      }
    }
  }
}

Kintone Lite