# Kintone MCP

> Kintone MCP connects your AI agent directly to your Kintone business applications. It lets you manage complex operational data—including creating, reading, updating, and deleting records across multiple apps—all through natural conversation. You can list every app available or query specific fields without ever opening the UI. This gives developers and operations teams granular control over low-code workflows, treating your entire Kintone instance like a database you talk to.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** low-code, workflow-automation, database-management, business-apps, collaboration, data-querying

## Description

You manage complex business data stored in Kintone using only natural conversation. Instead of logging into separate applications or building custom API calls, you just ask your AI agent what you need done. This MCP lets you inspect the structure of any app—checking field types and configurations—and then perform full CRUD (Create, Read, Update, Delete) operations on records across multiple apps. Need to query a specific deal in the 'Sales Pipeline' while simultaneously checking the details of the 'Customer DB'? You can do that. Your AI client handles the data flow, making your Kintone instance feel like one unified, conversational database. Vinkius hosts this MCP, giving your agent access to every toolset you need for deep operational control.

## Tools

### add_records
This tool adds one or more new records into a specified Kintone app.

### delete_records
This tool permanently removes selected records from an app.

### get_app_fields
It retrieves the full settings and definitions for all fields in a given Kintone app.

### get_record
You can fetch comprehensive details for one specific record using its ID.

### get_space_details
This tool gets background information about the Kintone space where apps are hosted.

### list_apps
It lists every single Kintone app that you have access to manage.

### list_records
You can pull a list of records from an app, optionally filtering them with a query string.

### update_records
This tool changes the content of one or more existing records in an app.

## Prompt Examples

**Prompt:** 
```
List all apps and show the latest 5 records from the 'Sales Pipeline' app.
```

**Response:** 
```
Apps: 6. Sales Pipeline (234 records), Customer DB (456), Inventory (89), HR Requests (34), Bug Tracker (123), Expenses (67). Latest Sales Pipeline: 1) Acme Corp — $45K, Stage: Proposal. 2) TechCo — $28K, Negotiation. 3) StartupXYZ — $12K, Demo. 4) GlobalInc — $67K, Closing. 5) MediCorp — $33K, Qualification.
```

**Prompt:** 
```
Create a new deal in Sales Pipeline and query all deals over $50K.
```

**Response:** 
```
Record created! 'NovaTech Partnership' — $85K, Stage: Proposal, Owner: Sarah. Pipeline: 235 records. Deals over $50K: 4 records. 1) NovaTech — $85K (Proposal). 2) GlobalInc — $67K (Closing). 3) EntCorp — $120K (Negotiation). 4) MegaGroup — $55K (Demo). Total pipeline value >$50K: $327K.
```

**Prompt:** 
```
Show the field configuration for the Customer DB app.
```

**Response:** 
```
Customer DB fields: 10. Company Name (text, required), Contact Email (email), Phone (phone), Industry (dropdown: SaaS, Healthcare, Finance, Retail), Size (number), Annual Revenue (currency), Status (dropdown: Active, Prospect, Churned), Last Contact (date), Notes (textarea), Attachments (file). 456 records total.
```

## Capabilities

### List and Inspect Apps
The agent can list all Kintone apps and pull details on specific fields within them.

### Manage App Spaces
You can retrieve detailed information about the underlying spaces that host your applications.

### Query and List Records
The agent searches for records across any app, supporting advanced filtering using Kintone query syntax.

### View Single Record Details
You can pull the complete data profile of a single record when you know its ID.

### Create New Records
The agent generates and adds one or more new records into any app.

### Modify Existing Data
You can update multiple fields across several existing records simultaneously.

### Remove Records
The agent deletes specified records from an app when they are obsolete.

## Use Cases

### Auditing old data for compliance
A manager needs to know who was assigned to a specific project three months ago. They tell their agent, 'List records in the Project Tracker app where Status is Closed and find the owner.' The agent uses list_records and get_record to pull the required historical assignment details.

### Migrating client data
A developer needs to move 50 new user entries into the HR system. They use add_records, providing a JSON array of records, which populates the target app instantly without any manual form entry.

### Correcting old client information
The sales team found that 10 deals have incorrect owner names. They prompt the agent to use update_records across the 'Sales Pipeline' app, correcting all owners and ensuring data consistency.

### Building a cross-app dashboard view
An analyst needs to know if an inventory item (Inventory App) is ready for a client who was recently onboarded (Customer DB App). They query both apps sequentially using list_records and get_record, creating a unified data report.

## Benefits

- You gain total visibility into your platform structure. Use list_apps and get_app_fields to map out every available app and field type without clicking through the UI.
- Eliminate manual reporting cycles. Instead of querying reports, simply ask the agent to list records or run a query on data that spans multiple apps simultaneously.
- Automate daily maintenance tasks instantly. Need to onboard new client data? Use add_records to populate dozens of records across different departmental apps in one prompt.
- Maintain clean data integrity. When business logic changes, use update_records and delete_records directly through your agent instead of having to manually edit the source app.
- Simplify troubleshooting. If a record is missing or incorrect, you don't have to guess; use get_record with just an ID to pull the full profile instantly.

## How It Works

The bottom line is, your AI client treats your entire low-code platform like an extension of its memory, allowing you to work with structured business data conversationally.

1. Subscribe to this MCP and provide your Kintone domain and API Token.
2. Your AI client connects, authenticating access to all the apps and spaces you manage within Kintone.
3. You speak a request—like 'Show me all deals over $50K in Sales Pipeline'—and the agent uses the appropriate tools to execute the data action.

## Frequently Asked Questions

**Can I use Kintone MCP to see what apps are available?**
Yes, you can use list_apps. This tool retrieves a comprehensive list of all the specific Kintone applications that your agent has access to.

**How do I check the fields in an app using Kintone MCP?**
Use get_app_fields. It pulls up the full configuration, telling you every field name and its data type (like dropdown or text) so your agent knows exactly how to interact with it.

**What is the difference between list_records and get_record in Kintone MCP?**
list_records pulls a filtered list of multiple records, while get_record retrieves all available data for one specific record using its unique ID.

**Can I bulk update multiple client records with Kintone MCP?**
Yep. Use update_records. You can pass a batch of JSON objects to change fields, like updating the 'Status' field for 20 different clients at once.

**Does Kintone MCP allow me to delete old records?**
Yes, you can use delete_records. This tool is designed to remove specified records from an app when they are no longer needed or compliant.