Kintone MCP Server

kintone official MCP server

Local serverstdio

What is the Kintone MCP server?

kintone official MCP server. The kintone mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

[![ci][ci-badge]][ci-url] [![npm version][npm-badge]][npm-url] [![License: Apache 2.0][license-badge]][license-url] [![Install MCP Server][cursor-badge]][cursor-url]

Its toolset

Everything the assistant can do here goes through one of these:

  • Cursor — .cursor/mcp.json [ref]
  • kintone-get-apps — 複数のアプリ情報を取得
  • kintone-get-app — 単一アプリの詳細情報を取得
  • kintone-get-form-fields — アプリのフィールド設定を取得
  • kintone-get-form-layout — アプリのフォームレイアウトを取得
  • kintone-update-form-fields — アプリのフィールド設定を更新
  • kintone-update-form-layout — アプリのフォームレイアウトを更新
  • kintone-delete-form-fields — アプリのフィールドを削除
  • kintone-get-process-management — プロセス管理設定を取得
  • kintone-get-app-deploy-status — アプリ設定の運用環境への反映状況確認
  • kintone-get-general-settings — アプリの一般設定を取得
  • kintone-add-form-fields — アプリにフィールドを追加

Configuration

You will need 6 environment variables: KINTONE_BASE_URL, KINTONE_USERNAME, KINTONE_PASSWORD, HTTPS_PROXY, KINTONE_API_TOKEN, KINTONE_PFX_FILE_PATH. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at @kintone/mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Plenty of cloud and infrastructure servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Kintone's toolset — Cursor, kintone-get-apps, kintone-get-app and 11 more — is a fair guide to whether it matches your workflow. It is maintained by kintone; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Kintone.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the kintone mcp server does with a few real requests.

Available tools

ToolWhat it does
Cursor.cursor/mcp.json \[[ref](https://docs.cursor.com/ja/context/mcp)]
kintone-get-apps複数のアプリ情報を取得
kintone-get-app単一アプリの詳細情報を取得
kintone-get-form-fieldsアプリのフィールド設定を取得
kintone-get-form-layoutアプリのフォームレイアウトを取得
kintone-update-form-fieldsアプリのフィールド設定を更新
kintone-update-form-layoutアプリのフォームレイアウトを更新
kintone-delete-form-fieldsアプリのフィールドを削除
kintone-get-process-managementプロセス管理設定を取得
kintone-get-app-deploy-statusアプリ設定の運用環境への反映状況確認
kintone-get-general-settingsアプリの一般設定を取得
kintone-add-form-fieldsアプリにフィールドを追加
kintone-get-records複数のレコードを取得
kintone-add-records複数のレコードを追加

How to install the Kintone MCP server

{
  "mcpServers": {
    "kintone": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KINTONE_BASE_URL",
        "-e",
        "KINTONE_USERNAME",
        "-e",
        "KINTONE_PASSWORD",
        "ghcr.io/kintone/mcp-server:latest"
      ],
      "cwd": "${cwd}",
      "env": {
        "KINTONE_BASE_URL": "https://example.cybozu.com",
        "KINTONE_USERNAME": "username",
        "KINTONE_PASSWORD": "password"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
KINTONE_BASE_URLEndpoint or connection string the server talks to.Yes
KINTONE_USERNAMEConfiguration value read at startup.Optional
KINTONE_PASSWORDConfiguration value read at startup.Optional
HTTPS_PROXYConfiguration value read at startup.Optional
KINTONE_API_TOKENCredential the server authenticates with.Yes
KINTONE_PFX_FILE_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Kintone to Cursor.
  • Use Kintone to kintone-get-apps.
  • Use Kintone to kintone-get-app.

Frequently asked questions

You can install via MCPB (drag and drop into Claude Desktop), Docker (`docker run ... ghcr.io/kintone/mcp-server`), or npm (`npm install -g @kintone/mcp-server`).