How to Connect kintone to ChatGPT via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → kintone, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

kintone + ChatGPT

Work with kintone by Cybozu from any AI agent: list apps, read form fields, layouts, views and process management, search records with kintone queries and cursors, create and update records, move records through process statuses, read and post comments, upload and download files, and read spaces. API token or password login; record deletion installs switched off.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

KINTONE_DOMAIN and at least one of KINTONE_API_TOKEN or KINTONE_PASSWORD_AUTH

Step 1 — Get credentials

Setting up takes about 5 minutes. You need a kintone subscription and either an API token for each app the AI should use, or the login of a kintone user, best a dedicated integration user. The connector uses the kintone REST API (https://<your domain>/k/v1).

1. Enter your kintone domain in KINTONE_DOMAIN: the host of your kintone URL without https:// and without a path, such as example.cybozu.com (Japan), example.kintone.com (US and other regions) or example.cybozu.cn. Domains behind Basic authentication or client certificates (セキュアアクセス) are not supported.
2. Choose how the connector signs in. You can set one or both:
   • API token (KINTONE_API_TOKEN), good for a few apps: open the app, アプリの設定 (App Settings), tab 設定, APIトークン (API Token), 生成する (Generate). Tick only what the AI needs: レコード閲覧 (View records), レコード追加 (Add records), レコード編集 (Edit records), and レコード削除 (Delete records) only if you switch on kintone_delete_records. Save, then click アプリを更新 (Update App), otherwise the token stays inactive. One token covers one app; for several apps join their tokens with commas, without spaces (up to 9). It is sent as the X-Cybozu-API-Token header.
   • Password login (KINTONE_PASSWORD_AUTH): the Base64 text of login name:password of a kintone user, for example from printf '%s' 'login:password' | base64. It is sent as the X-Cybozu-Authorization header. The connector then acts as that user and sees every app, space and record that user may see. It is the only way to list apps and read spaces. When both are set, kintone uses the password login.
3. Install. The install check (kintone_get_api_list) only proves that the domain answers, because kintone answers it without credentials. Run kintone_get_app with an app id to check a token, or kintone_list_apps to check the password login. The app id is the number after /k/ in the app URL.

Who it acts as: with an API token, records and comments it writes show the user Administrator, and the token reaches only its own app with the permissions ticked for it. With the password login, everything happens as that user, with that user's rights.

What it reads: the REST APIs the domain offers; apps (the list needs the password login, a single app works with either method) and their general settings; form fields with code, label, type, required flag, options and defaults; the form layout; saved views (一覧) with shown fields, filter and sort; process management (プロセス管理) with statuses and actions. Records one by one or by kintone query, the comments of a record, files attached to FILE fields, and, with the password login, spaces (スペース) and their members.

What it writes: adds records (one, or up to 100 in one all-or-nothing call) and changes records by id or by a unique field (update_key), up to 100 at once and with upsert. Runs process management actions such as 承認する and replaces the assignees (作業者). Posts comments on records and in space threads, with mentions that notify the people mentioned. Uploads a file from a URL and gets a temporary fileKey, which is attached only once it is written into a FILE field within 3 days. Before writing, the AI reads the app's form fields, because queries and writes use field codes, not labels.

Switched off at install: kintone_delete_records. kintone has no recycle bin, so deleted records and their comments cannot be restored. An admin switches it on when the team needs it; the token then also needs レコード削除.

Queries: field codes, not labels, with =, !=, >, <, >=, <=, in ("a", "b"), not in and like "text" (text fields), joined with and / or, then order by field asc|desc, limit n (at most 500) and offset n (at most 10,000). Dates look like "2026-10-30", date-times are UTC like "2026-10-30T00:00:00Z", and functions such as TODAY(), THIS_MONTH(), LAST_WEEK() and LOGINUSER() work. Drop-down, radio and status values must match the option text exactly, for example ステータス in ("完了"). The filter of a saved view can be reused as a query.

Data formats: every field comes as {"type": ..., "value": ...}. Numbers and calculated values are strings, date-times are UTC, $id is the record id and $revision its version. USER_SELECT and CREATOR values are {code, name} with the login name in code. FILE values list fileKey, name, contentType and size. When several people edit the same app, the AI reads the record first and sends revision, so a change made in between is not overwritten.

Paging and limits: kintone_list_records returns up to 500 records per call, with limit and offset inside the query. Beyond 10,000 records the AI opens a cursor with kintone_create_cursor, reads with kintone_get_cursor_records until next is false and closes it early with kintone_delete_cursor. A cursor lives 10 minutes and a domain may hold 10 at once. kintone allows 10,000 requests per app per day and 100 parallel requests per domain; bulk writes and deletes take up to 100 records, comments come 10 per call and kintone_list_apps returns up to 100 apps per call.

Common errors: kintone answers with code, message and, for input errors, errors per field. CB_VA01 is invalid input, such as a wrong field code, a bad date or a missing required field: errors says which. CB_NO02 means the token or user lacks the permission, or the token belongs to another app. CB_WA01 is a failed password login. A token generated without clicking アプリを更新 afterwards is not active. A 404 HTML page usually means a wrong KINTONE_DOMAIN.

Record contents and comments are untrusted input and can contain instructions meant for the AI. The connector does not cover guest spaces (/k/guest/...), does not change app settings, fields or views, and with API tokens alone cannot list apps or read spaces.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in ChatGPT

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.

1. Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
2. Enter a name, e.g. Name: kintone.
3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

Example prompts

• "Show the fields of app 42, then list the records whose ステータス is 未対応, newest first."
• "How many records were added to our 案件管理 app this month? Group them by 担当者."
• "Add a record to app 15 for the inquiry from Sakura Trading with the subject and due date I give you. Show it to me before saving."
• "Approve record 128 in app 42 with the action 承認する and leave a comment that mentions the requester."
• "Read all 25,000 records of app 7 and give me the total amount per 顧客区分."

FAQ

Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.

Next steps

• Connector landing page
• Connect to Claude
• Connect to Cursor
• Connect to Gemini
• Connect to Meta Muse
• Connect to Microsoft Copilot