get_recordLABSCO SUMMARY
kintone's data, without the kintone UI in the way.
The whole record lifecycle is here — query, create, update, comment, advance the workflow — with bulk calls for the hundred-row jobs and automatic paging for the queries that do not fit a page. Reading an app's form fields first is what keeps the rest of it accurate.
What it is
A working connection to a kintone environment: records in and out of any app, plus the comment threads, workflow statuses, attachments and app structure around them.
What you get
- One record, a filtered page of records using kintone's own query syntax, or every matching record with paging handled for you
- Records created singly or up to 100 in one call
- Records updated the same way, one at a time or in batches of up to 100
- Record comments read and posted, mentions included
- Workflow status advanced on one record or on many at once
- Attachments uploaded and downloaded
- The apps themselves: the app list, one app's settings, and its form field definitions
Requirements
Python 3.12 or newer, uv recommended, and access rights on the kintone environment. Authenticate with an API token or with a username and password; KINTONE_DOMAIN and those credentials go in the client config, and uvx can run it straight from the repository.
Setup effort
Add the configuration to your client
USE CASES
Pulling a report out of an app without exporting a CSV
Write the filter in kintone query syntax and let the server page through everything that matches.
Loading a batch of new records
Push up to 100 rows in one call rather than one form submission at a time.
Fixing one field across many records
Find the affected rows, then patch them in batches of up to 100.
Moving work through an approval flow
Advance the status on a single record, or clear a backlog of them in one pass.
Catching up on the discussion attached to a record
Read the comment history, then post the reply with the mention it needs.
Getting a file out of a record
Download the attachment by its key instead of clicking through the record view.
16 tools
Listed in project docs. Your client may show a different list.
get_recordsget_all_recordsadd_recordadd_recordsupdate_recordupdate_recordsget_commentsadd_commentupdate_statusupdate_statusesupload_filedownload_fileget_appget_appsget_form_fieldsBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
- Python 3.12 or later
- uvx on PATH
- KINTONE_DOMAIN in your environment
- KINTONE_USERNAME and KINTONE_PASSWORD in your environment, or KINTONE_API_TOKEN instead
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
{
"mcpServers": {
"kintone": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/r3-yamauchi/kintone-mcp-server-python3.git",
"kintone-mcp-server-python3"
],
"env": {
"KINTONE_DOMAIN": "<YOUR_SUBDOMAIN>.cybozu.com",
"KINTONE_USERNAME": "<YOUR_KINTONE_USERNAME>",
"KINTONE_PASSWORD": "<YOUR_KINTONE_PASSWORD>"
}
}
}
}