Kintone

Provides secure access to Kintone apps and records for MCP-enabled AI assistants.

python

1

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "luvl-mcp-kintone-lite": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-kintone-lite",
        "mcp-kintone-lite"
      ],
      "env": {
        "KINTONE_PASSWORD": "YOUR_PASSWORD_PLACEHOLDER",
        "KINTONE_USERNAME": "YOUR_USERNAME_PLACEHOLDER",
        "KINTONE_SUBDOMAIN": "YOUR_SUBDOMAIN_PLACEHOLDER"
      }
    }
  }
}

You can connect AI assistants to Kintone data and apps through a lightweight MCP server that handles authentication, data access, and CRUD operations. This server lets you query apps, fetch records, and perform create, update, and delete actions securely, enabling automated workflows and AI-powered interactions with Kintone.

How to use

Use a compatible MCP client to connect to the Kintone MCP server. The recommended approach is to run the MCP server locally and start it through your MCP client, then point your client at the local server to access Kintone data and operations.

Typical usage patterns include listing available Kintone apps, retrieving form fields for a specific app, querying records with filters and pagination, and performing CRUD operations on records. Your client will communicate actions to the MCP server, which translates them into Kintone API calls while enforcing security checks.

How to install

Prerequisites: you need Python 3.10 or higher, and a Kintone account with a username and password. You also need your Kintone subdomain.

Install the MCP server from PyPI using the package manager for Python.

pip install mcp-kintone-lite

Additional setup and configuration

Configure your MCP client to connect to the server by providing Kintone credentials as environment variables. The following environment variables are used in the recommended setup.

KINTONE_SUBDOMAIN: Your Kintone subdomain (for example, mycompany).

KINTONE_USERNAME: Your Kintone username.

KINTONE_PASSWORD: Your Kintone password.

Running locally with Claude Desktop (recommended workflow)

To run the MCP server with Claude Desktop, use the following runtime configuration. This starts the server via the UVX runner and passes the correct identifiers for your MCP server.

{
  "mcpServers": {
    "kintone-lite": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-kintone-lite",
        "mcp-kintone-lite"
      ],
      "env": {
        "KINTONE_SUBDOMAIN": "your-subdomain",
        "KINTONE_USERNAME": "your-username",
        "KINTONE_PASSWORD": "your-password"
      }
    }
  }
}

Available tools

authenticate

Validate credentials against Kintone and establish a secure session for subsequent MCP operations.

list_apps

Return a list of Kintone apps accessible by the authenticated user, respecting Kintone permissions.

query_records

Execute filtered queries against Kintone records with support for pagination.

crud_records

Create, read, update, and delete Kintone records via MCP translations of Kintone API calls.

validate_security

Enforce built-in security and input validation to prevent unauthorized access or malformed requests.

setup

Provide easy setup and configuration steps to connect an MCP client with the Kintone MCP server.