Connect your AI Agents to Kintone in minutes
Available tools
get_app
Get general information of a Kintone app including name, description, Space, creator and updater info.
get_apps
List Kintone apps with optional filters by IDs, codes, name, or Space IDs. Supports pagination with limit (max 100) and offset parameters.
get_form_fields
Get the list of fields and field settings of a Kintone app. Returns field codes, types, labels, and configuration. Essential for building record queries.
get_form_layout
Get the field layout of a Kintone app form, including row structure, field sizes, and grouping.
get_app_views
Get the list of views (custom views, calendar views, etc.) configured for a Kintone app.
get_record_comments
Get comments on a record. Returns up to 10 comments per request. Use offset for pagination and order (asc/desc) for sorting.
add_record_comment
Add a comment to a record. Comment must include a 'text' key. Optionally include 'mentions' to notify users. Example: {"text": "Hello!", "mentions": [{"code": "user@example.com", "type": "USER"}]}
delete_record_comment
Delete a comment from a record. Only the comment creator or an App admin can delete comments.
upload_file
Upload a file to Kintone. Provide file_name and base64-encoded file_data. Returns a fileKey that can be used in record attachment fields. The file is deleted after 3 days if not attached to a record.
get_record
Get a single record from a Kintone app by record ID. Use get_apps to find the App ID, then get_form_fields to discover field codes.
get_records
Get multiple records from a Kintone app. Supports query filtering, field selection, and pagination via query string (e.g., 'limit 100 offset 0'). Max 500 per request. Use get_form_fields to discover available field codes for filtering.
add_record
Add a single record to a Kintone app. Record data must use field code keys with value objects. Example: {"Text_field": {"value": "hello"}}. Use get_form_fields to discover field codes.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Kintone MCP server
FAQs on using Merge's Kintone MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
