open-source

MCP Kintone Lite: Lightweight AI-Kintone Integration

June 28, 2025

I’m excited to announce the release of MCP Kintone Lite, a streamlined Model Context Protocol (MCP) server that bridges AI assistants with Kintone business process platform. This lightweight solution is perfect for automating workflows and integrating Kintone with AI tools.

Technical Stack

Core Framework

  • FastMCP: High-level MCP implementation for rapid development
  • Python 3.10+: Modern Python features and performance
  • Kintone SDK: Direct API integration with Kintone platform

AI Integration

  • Model Context Protocol (MCP): Anthropic’s open standard for AI-data connections
  • Claude Desktop: Primary target for seamless AI integration
  • Basic Authentication: Secure Kintone username/password authentication

Development Tools

  • UV: Ultra-fast Python package manager and runner
  • Poetry: Alternative dependency management
  • PyPI: Published package for easy installation

Key Features

Kintone Operations

  • Access all Kintone apps based on user permissions
  • Execute queries with filtering and pagination
  • Perform CRUD operations on Kintone records
  • Retrieve app form fields and metadata

Security & Performance

  • Secure Basic Authentication (username/password)
  • Built-in validation and error handling
  • Comprehensive input validation
  • Production-ready security measures

Developer Experience

  • One-command installation: pip install mcp-kintone-lite
  • Multiple deployment options (UV, Poetry, direct Python)
  • Comprehensive documentation and examples
  • Easy Claude Desktop integration

Project Structure

mcp-kintone-lite/
├── src/
│   └── mcp_kintone_lite/
│       ├── server.py          # Main MCP server
│       ├── client.py          # Kintone client wrapper
│       ├── config.py          # Configuration management
│       └── tools/
│           ├── query.py       # Query and search tools
│           ├── crud.py        # CRUD operations
│           └── metadata.py    # App metadata tools
├── examples/                  # Usage examples and configs
├── assets/                    # Demo materials
└── pyproject.toml            # Package configuration

Getting Started

Quick Installation

# Install from PyPI
pip install mcp-kintone-lite

# Use with Claude Desktop
uvx --from mcp-kintone-lite mcp-kintone-lite

Claude Desktop Integration

Add to your Claude Desktop configuration:

{
  "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"
      }
    }
  }
}

Development Setup

# Clone and install for development
git clone https://github.com/luvl/mcp-kintone-lite.git
cd mcp-kintone-lite
uv sync  # or poetry install

Available Tools

The server provides AI assistants with these capabilities:

Query Operations

  • get_records: Retrieve records from Kintone apps with filtering
  • search_apps: Search and list available Kintone applications
  • get_app_form: Get form fields and metadata for specific apps

CRUD Operations

  • create_record: Create new records in Kintone apps
  • update_record: Modify existing records
  • delete_record: Remove records with confirmation

Metadata Access

  • list_apps: Browse all available Kintone applications
  • get_app_fields: Get detailed field information for apps
  • get_app_settings: Retrieve app configuration and settings

Why MCP Kintone Lite?

This project fills a specific need in the AI integration landscape:

Lightweight Focus

Unlike comprehensive business process platforms, this server focuses on essential Kintone operations, making it perfect for:

  • Workflow automation
  • Data extraction and analysis
  • AI-powered business process optimization
  • Quick prototyping with Kintone data

MCP Standard Compliance

Built on Anthropic’s Model Context Protocol, ensuring:

  • Universal AI assistant compatibility
  • Standardized tool definitions
  • Future-proof architecture
  • Community ecosystem benefits

Business Process Integration

Kintone’s strength in business process management combined with AI capabilities enables:

  • Intelligent workflow automation
  • Data-driven decision making
  • Streamlined business operations
  • Enhanced productivity tools

Future Development

The roadmap for MCP Kintone Lite includes:

  • Advanced filtering and sorting options
  • Bulk operation support
  • Workflow automation tools
  • Enhanced app metadata access
  • Integration with Kintone plugins

Contributing

MCP Kintone Lite is open source and welcomes contributions! Whether it’s bug reports, feature requests, or code improvements, please feel free to get involved.

Resources

License

MCP Kintone Lite is released under the MIT license. See the LICENSE file for more details.

Ready to connect your AI assistant to Kintone? Try MCP Kintone Lite today and experience seamless business process automation in minutes!