What is Kintone Mcp Python

Kintone-mcp-python is a Model Context Protocol (MCP) Server that enables the use of Kintone API functionalities. It is developed using Python and Node.js, allowing for natural language operations on Kintone through integration with platforms like Claude Desktop.

Use cases

Use cases for Kintone-mcp-python include automating data entry processes, integrating Kintone with other applications for enhanced functionality, managing user access and permissions, and facilitating collaborative work environments through shared applications.

How to use

To use Kintone-mcp-python, clone the repository, install the necessary Python and Node.js dependencies, configure authentication in the .env file, and set up Claude Desktop according to the provided setup guide. Finally, run integration tests to verify functionality.

Key features

Key features include record operations (searching, retrieving, creating, updating records, and adding comments), app management (retrieving, creating, deploying apps, and updating settings), field and layout management (adding, updating, deleting fields, and designing forms), user management (retrieving user and group information, adding guest users), and file operations (uploading and downloading files).

Where to use

Kintone-mcp-python can be used in various fields that require data management and workflow automation, such as project management, customer relationship management (CRM), and enterprise resource planning (ERP).

Kintone MCP Server

Kintone MCP (Model Context Protocol) Server は、Kintone API機能を利用できるようにするMCPサーバーです。
PythonとJSを用いて開発しました。

🎯 概要

• Python MCP Server + Node.js API Wrapperアーキテクチャ
• Claude Desktopなどとの統合により自然言語でKintone操作が可能

🚀 主要機能

レコード操作

• レコード検索・取得・作成・更新
• レコードコメント追加

アプリ管理

• アプリ情報取得・作成・デプロイ
• アプリ設定の更新・管理

フィールド・レイアウト

• フィールド追加・更新・削除
• フォームレイアウトの設計・変更

ユーザー管理

• ユーザー・グループ情報取得
• ゲストユーザー追加

ファイル操作

• ファイルアップロード・ダウンロード

📁 プロジェクト構成

kintone-mcp-server/
├── src/                                # メインソースコード
│   ├── python/                         # Python MCP Server
│   │   ├── main.py                     # メインサーバーファイル
│   │   ├── .env                        # 環境変数
│   │   ├── requirements.txt            # Python依存関係
│   │   └── server/                     # サーバー実装
│   └── nodejs/                         # Node.js API Wrapper
│       ├── wrapper.mjs                 # APIラッパー
│       └── package.json                # Node.js依存関係
├── config/                             # 設定ファイル
│   └── claude-desktop/                 # Claude Desktop設定
│       ├── recommended.json            # 推奨設定
│       ├── debug.json                  # デバッグ用設定
│       └── setup-guide.md              # セットアップガイド
├── tests/                              # テスト
├── tools/                              # 開発ツール
└── archive/                            # 開発履歴アーカイブ

⚡ クイックスタート

1. 環境設定

# リポジトリをクローン
git clone <repository-url>
cd kintone-mcp-server

# Python依存関係インストール
cd src/python
pip install -r requirements.txt

# Node.js依存関係インストール
cd ../nodejs
npm install

2. 認証設定

src/python/.env ファイルを作成：

KINTONE_DOMAIN=your-domain.cybozu.com
KINTONE_USERNAME=your-username
KINTONE_PASSWORD=your-password
# または
KINTONE_API_TOKEN=your-api-token

3. Claude Desktop設定

config/claude-desktop/recommended.json の内容をClaude Desktopの設定ファイルに追加してください。

詳細は config/claude-desktop/setup-guide.md をご確認ください。

4. 動作確認

# テスト実行
cd tests/integration
python test_mcp_client.py

🔧 開発者向け情報

アーキテクチャ

1. Python側: MCPプロトコル処理とツール定義管理
2. Node.js側: Kintone API実行 (@kintone/rest-api-client使用)
3. 統一実行: 全ツールがNode.js経由で実行される

主要ファイル

• src/python/main.py: メインMCPサーバー
• src/nodejs/wrapper.mjs: Node.js APIラッパー
• config/claude-desktop/recommended.json: Claude Desktop設定例

📄 ライセンス

MIT License

注意事項

「kintone」はサイボウズ株式会社の登録商標です。

このソースコードは技術検証を目的としており、実際の動作は保証しません。

また、公開している内容は情報提供を目的としており、個別のサポートはできません。

設定内容についてのご質問や動作しないといったお問い合わせには対応ができませんので、ご承知おきください。