mcp-kintone-lite

Simple and lightweight Kintone MCP server for connecting AI assistants to Kintone applications and data. Perfect for automating workflows and integrating Kintone with AI tools.

📦 Install from PyPI: pip install mcp-kintone-lite

🔗 PyPI Package: https://pypi.org/project/mcp-kintone-lite/

📚 GitHub Repository: https://github.com/luvl/mcp-kintone-lite

Demo

See the MCP Kintone Lite server in action with Claude Desktop:

The demo shows Claude Desktop using the MCP server to interact with Kintone data - querying apps, retrieving records, and performing CRUD operations seamlessly.

Overview

This MCP (Model Context Protocol) server provides AI assistants like Claude with secure access to Kintone applications and data. It implements the MCP standard to enable seamless integration between AI applications and Kintone's business process platform.

Features

• 🔐 Secure Kintone authentication via Basic Authentication (username/password)

• 📊 Access to all Kintone apps (based on user permissions)

• 🔍 Query execution with filtering and pagination

• 📝 CRUD operations on Kintone records

• 🛡️ Built-in security and validation

• 🚀 Easy setup and configuration

Quick Usage

Works with: Claude Desktop, any MCP-compatible AI assistant

Quick Start with Claude Desktop

Production Usage (Recommended)

The easiest way to use this MCP server is to install it directly from PyPI and configure it with Claude Desktop.

Step 1: Configure Claude Desktop

Add the following configuration to your Claude Desktop settings file:

Configuration File Location:

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

Step 2: Set Up Kintone Credentials

Replace the environment variables in the configuration:

• KINTONE_SUBDOMAIN: Your Kintone subdomain (e.g., mycompany for mycompany.cybozu.com)

• KINTONE_USERNAME: Your Kintone username

• KINTONE_PASSWORD: Your Kintone password

Step 3: Restart Claude Desktop

After saving the configuration, restart Claude Desktop. You should see a hammer icon indicating that tools are available.

Step 4: Test the Integration

Try asking Claude:

• "List available Kintone apps"

• "Get form fields for app 123"

• "Get records from app 456 with status 'Active'"

Prerequisites

• Python 3.10 or higher

• Kintone account with username and password

• Kintone subdomain (e.g., yourcompany.cybozu.com)

Development Setup

If you want to modify or contribute to this MCP server, follow these development setup instructions.

Installation

Option 1: Using uv (Recommended for development)

Option 2: Using Poetry

Kintone Development Setup

Create a .env file in the project root:

Usage

Development Mode

First, make sure you have your Kintone credentials configured in your .env file.

Method 1: Direct Python Execution

Method 2: Using Poetry

Method 3: Using UV (Recommended)

Testing with MCP Inspector

If you have the MCP CLI installed, you can test your server:

Publishing Process

1. Test on TestPyPI first:

2. Publish to Production PyPI:

Version Management

To publish a new version:

1. Update the version in pyproject.toml

2. Rebuild: uv build or poetry build

3. Upload: twine upload --repository pypi --config-file .pypirc dist/*