# Kintone MCP > Kintone MCP connects your AI agent directly into your custom Kintone environment. It lets you manage business data, discover apps, and automate workflows using natural language commands. Instead of logging into a web portal or exporting CSV files, your agent can list records, add new entries, update status fields, and even map out which applications exist across your organization—all from any MCP-compatible client. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** business-apps, workflow-automation, low-code, data-records, team-collaboration, custom-apps ## Description Your agent needs to interact with structured data where it lives: Kintone. This MCP gives it that access. You no longer have to switch context or manually copy data between systems just to update a status or check a project's current state. With this connection, your AI agent becomes an extension of your team, capable of navigating all the custom apps you've built and handling records across every space. It can list which apps exist on your platform, retrieve specific records based on complex criteria, or even map out exactly how a form is structured. If you use Vinkius to manage your AI tools, this MCP makes Kintone data available for action alongside everything else in the catalog. ## Tools ### add_record Creates a brand new record in an app using a defined JSON structure of field codes and values. ### get_app_layout Retrieves the detailed layout, including field names and types, for a specific Kintone application. ### list_apps Lists every existing Kintone application ID so you know which apps you can target with your commands. ### delete_records Permanently removes one or more records from an app using a required array of record IDs. ### list_form_fields Displays all field names and settings for a particular application, helping you understand the data structure. ### get_app_details Pulls general metadata and configuration details about an entire Kintone application. ### get_record Retrieves the full content of a single, specific record from any app using its unique ID. ### list_records Searches and lists multiple records in an app; you can optionally add a query string to filter results immediately. ### list_space_members Lists all members, participants, and roles within your organization's Kintone collaboration space. ### update_record Changes the data on an existing record by accepting a specific ID and mapping new values to fields. ## Prompt Examples **Prompt:** ``` List all my Kintone apps. ``` **Response:** ``` I've retrieved your apps. You have 5 applications, including 'Sales Pipeline' (ID: 10), 'Employee Directory' (ID: 12), and 'Project Tracker' (ID: 15). ``` **Prompt:** ``` Show records from app ID 10 where status is 'Pending'. ``` **Response:** ``` I found 3 records in app 10 with 'Pending' status: 'Opportunity A', 'Opportunity B', and 'Opportunity C'. Would you like to see details for any of them? ``` **Prompt:** ``` Add a new record to app 12 with name 'Jane Doe' and role 'Designer'. ``` **Response:** ``` Successfully added the record for 'Jane Doe' to app 12. The new record ID is '105'. ``` ## Capabilities ### Discovering Apps Lists every custom application and provides detailed information about its structure and fields. ### Retrieving Specific Records Fetches a single, specific record from any configured Kintone app using unique identifiers. ### Querying Record Lists Searches and retrieves multiple records across an app, allowing filtering based on complex criteria like status or date range. ### Adding New Entries Creates brand new records in any specified Kintone application, mapping data fields as needed. ### Modifying Existing Data Updates specific details on an existing record, such as changing a status or assigning a new owner. ### Managing Space Members Lists all users and participants within your defined Kintone collaboration spaces. ## Use Cases ### Project status audit A project manager needs to check if five different tasks—spread across 'Task App,' 'Budget App,' and 'Owner App'—are all marked complete. They ask their agent, which uses `list_records` repeatedly, and the agent reports back a clear list of all 15 records that are still pending review. ### Onboarding new staff An HR specialist needs to create profiles for three new employees. Using `add_record`, they provide the name, department ID, and start date once, and the agent populates all necessary records into the 'Employee Directory' app. ### Data clean-up sweep The operations team finds a batch of old, incomplete opportunity records. They ask the agent to find all records in the 'Opportunity Tracker' where the status is 'Draft' and then use `delete_records` to purge them safely. ### App discovery for new users A business analyst joins a department and doesn't know what data apps exist. They ask, and the agent uses `list_apps` immediately, providing an inventory of every application ID available to them. ## Benefits - Automate data entry: Instead of manually clicking through forms, you can use `add_record` to create new entries instantly by describing the required information to your agent. - Instant status checks: Need to know if a project is stuck? Use `list_records` with complex filters to gather all records matching 'Stalled' and see exactly which projects are affected. - Accurate data mapping: If you don't know what fields exist, run `get_app_layout` first. This tells your agent the exact structure of the app before it tries to add or update anything. - System oversight: Use `list_apps` to get a complete inventory of every custom application ID, letting you manage data across the whole platform in one chat session. - Deep record retrieval: Instead of just getting a list, use `get_record` when you need all the specific details for a single item, like an employee's full profile or opportunity history. ## How It Works The bottom line is that you grant your AI client permission to act on behalf of your account, running native Kintone operations through natural language conversation. 1. Subscribe to this MCP on Vinkius, then input your specific Kintone Subdomain and API Token credentials. 2. Connect your AI client (Claude, Cursor, etc.) using the established connection in your preferred development environment. 3. Ask your agent a question like, 'List all project records with status Pending,' and it executes the command against your live Kintone data. ## Frequently Asked Questions **How do I list all my Kintone apps using the Kintone MCP?** Run the `list_apps` tool. This will provide a complete inventory of every custom application ID available in your account, letting you know exactly what data sources your agent can access. **What is the difference between listing records and getting a specific record with Kintone MCP?** Use `list_records` when you need to search many items based on criteria (e.g., status='Pending'). Use `get_record` only when you know the exact ID of the single item you want details for. **Can I add a new record without knowing all the field names? Kintone MCP?** No. To ensure data integrity, you should run `list_form_fields` first to verify the precise name and required type of every field before attempting to use `add_record`. **Does this MCP let me delete records from multiple apps?** Yes. You can list records across different apps using various tools, and then pass the resulting IDs to `delete_records` in a single command sequence for bulk cleanup.