kintone

What is mcp-server-kintone?

mcp-server-kintone is a server implementation of the Model Context Protocol (MCP) specifically designed to integrate with kintone. It allows users to manage records and applications within kintone using AI tools, such as Claude Desktop, by translating natural language queries into actions within kintone.

How to use mcp-server-kintone?

1. Install: Download the latest release executable from the official GitHub release page and place it in your desired location.
2. Configure MCP client: Edit the configuration file of your MCP client (e.g., claude_desktop_config.json for Claude Desktop) to add a new MCP server entry for kintone. This involves specifying the path to the mcp-server-kintone.exe executable and configuring environment variables for kintone authentication (KINTONE_BASE_URL, KINTONE_USERNAME, KINTONE_PASSWORD, KINTONE_API_TOKEN) and optional app access control (KINTONE_ALLOW_APPS, KINTONE_DENY_APPS).
3. Start to use: After restarting your MCP client, you can begin interacting with kintone data using natural language commands through your AI tool.

Key Features of mcp-server-kintone

• AI-powered kintone interaction: Enables exploration and manipulation of kintone data using AI tools.
• Model Context Protocol (MCP) compliant: Built on the MCP standard for seamless integration with various AI clients.
• Flexible authentication: Supports both username/password and API token authentication for kintone.
• Granular app access control: Allows specifying allowed or denied kintone applications for AI access.
• Easy installation: Simple installation process by downloading a pre-compiled executable.

Use Cases of mcp-server-kintone

• Automated data retrieval: Quickly fetch specific records or summaries from kintone using natural language queries (e.g., "What is the latest status of Customer A's project?").
• Effortless data updates: Update kintone records with simple commands (e.g., "Update the progress of Project B to 50%.").
• Intelligent data analysis: Ask AI tools to identify and present data based on criteria (e.g., "Show me the projects that are behind schedule.").
• Streamlined workflow management: Integrate kintone operations into AI-driven workflows for increased productivity.

FAQ from mcp-server-kintone

• What is MCP? MCP stands for Model Context Protocol, a protocol that allows AI models to interact with external tools and data.
• Which AI tools are supported? While specifically mentioning Claude Desktop, any AI tool that supports the Model Context Protocol can potentially be used with mcp-server-kintone.
• How do I authenticate with kintone? You can authenticate using either a username and password or by providing one or more API tokens.
• Can I control which kintone apps the AI can access? Yes, you can use the KINTONE_ALLOW_APPS and KINTONE_DENY_APPS environment variables to specify which apps are accessible.
• Where can I find the latest release? The latest release can be downloaded from the release page on GitHub.

MCP server for kintone

Model Context Protocol (MCP) server for kintone. This server allows you to explore and manipulate kintone data using AI tools such as Claude Desktop!

Japanese version: 日本語の説明はREADME.ja.mdにあります。

Usage

1. Install

Download the latest release from the release page. You can place the executable file anywhere you like.

2. Configure MCP client like Claude Desktop

Configure your client to connect to the server.

For Claude Desktop, please edit file below:

• MacOS/Linux: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration to the mcpServers section:

{
  "mcpServers": {
    "kintone": {
      "command": "C:\\path\\to\\mcp-server-kintone.exe",
      "env": {
        "KINTONE_BASE_URL": "https://<domain>.cybozu.com",
        "KINTONE_USERNAME": "<your username>",
        "KINTONE_PASSWORD": "<your password>",
        "KINTONE_API_TOKEN": "<your api token>, <another api token>, ...",
        "KINTONE_ALLOW_APPS": "1, 2, 3, ...",
        "KINTONE_DENY_APPS": "4, 5, ..."
      }
    }
  }
}

Environment variables:

• KINTONE_BASE_URL: (Required) The base URL of your kintone.
• KINTONE_USERNAME: Your username for kintone.
• KINTONE_PASSWORD: Your password for kintone.
• KINTONE_API_TOKEN: Comma separated API token for kintone. You need to set either KINTONE_USERNAME and KINTONE_PASSWORD or KINTONE_API_TOKEN.
• KINTONE_ALLOW_APPS: A comma-separated list of app IDs that you want to allow access. In default, all apps are allowed.
• KINTONE_DENY_APPS: A comma-separated list of app IDs that you want to deny access. The deny has a higher priority than the allow.

You may need to restart Claude Desktop to apply the changes.

3. Start to use

Now you can interact with kintone using your own AI tools!

For example, you can say:

• "What is the latest status of Customer A's project?"
• "Update the progress of Project B to 50%."
• "Show me the projects that are behind schedule."