Merge Unified's Kintone integration Merge Agent Handler's Kintone MCP server

Connect your AI Agents to Kintone in minutes

Merge lets you securely connect your agents to Kintone and thousands of tools instantly

Start building for free

Read docs

Kintone

Learn more about Merge Agent Handler

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.

View all tools by creating a free account

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}
11

Copy Code

Open 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}

Copy Code

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  }

Copy Code

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}

Copy Code

FAQs on using Merge's Kintone MCP server

Explore other MCP servers built and managed by Merge

Wix

WordPress

Workday

Xero

Yelp

YouTube

Zendesk

Zendesk Sell

Zoho CRM

Zoho Desk

Zoom

ZoomInfo

bioRxiv

n8n

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