@kintone/mcp-server 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.5.0](https://github.com/kintone/mcp-server/compare/1.4.0...1.5.0) (2026-06-02)
+
+
+### Features
+
+* add kintone record comment tools (get/add) ([#414](https://github.com/kintone/mcp-server/issues/414)) ([d2ae555](https://github.com/kintone/mcp-server/commit/d2ae55519c1312e38fe4666f853086b44458fadc))
+
+
+### Bug Fixes
+
+* **deps:** update dependency @modelcontextprotocol/sdk to v1.29.0 ([#317](https://github.com/kintone/mcp-server/issues/317)) ([1688179](https://github.com/kintone/mcp-server/commit/168817913c7a7927dc7304cce949e0efbcaa6793))
+* remove stray console.log polluting MCP stdio stream ([#463](https://github.com/kintone/mcp-server/issues/463)) ([ab15d5a](https://github.com/kintone/mcp-server/commit/ab15d5a9525d45e64d2e8396d0ae568a20671d2f))
+* use --node-linker=hoisted instead of --shamefully-hoist ([#459](https://github.com/kintone/mcp-server/issues/459)) ([a276b1c](https://github.com/kintone/mcp-server/commit/a276b1ca4939b68f858a2ddbb2186efccb57adc2))
+
 ## [1.4.0](https://github.com/kintone/mcp-server/compare/1.3.15...1.4.0) (2026-05-27)
 
 

package/README.md

@@ -209,6 +209,8 @@ export HTTPS_PROXY="http://username:password@proxy.example.com:8080"
 | `kintone-update-records`          | 複数のレコードを更新                   |
 | `kintone-delete-records`          | 複数のレコードを削除                   |
 | `kintone-update-statuses`         | 複数のレコードのステータスを更新       |
+| `kintone-get-record-comments`     | レコードのコメントを取得               |
+| `kintone-add-record-comment`      | レコードにコメントを追加               |
 | `kintone-add-app`                 | 動作テスト環境にアプリを作成           |
 | `kintone-deploy-app`              | アプリ設定を運用環境へ反映             |
 | `kintone-update-general-settings` | アプリの一般設定を変更                 |

package/dist/tools/index.js

@@ -1,5 +1,7 @@
+import { addRecordComment } from "./kintone/record/add-record-comment.js";
 import { addRecords } from "./kintone/record/add-records.js";
 import { deleteRecords } from "./kintone/record/delete-records.js";
+import { getRecordComments } from "./kintone/record/get-record-comments.js";
 import { getRecords } from "./kintone/record/get-records.js";
 import { updateRecords } from "./kintone/record/update-records.js";
 import { getApp } from "./kintone/app/get-app.js";
@@ -36,6 +38,8 @@ export const tools = [
     addRecords,
     deleteRecords,
     getRecords,
+    getRecordComments,
+    addRecordComment,
     updateRecords,
     addApp,
     deployApp,

package/dist/tools/kintone/app/get-general-settings.js

@@ -89,7 +89,6 @@ const toolConfig = {
 };
 const callback = async ({ app, lang, preview }, { client }) => {
     const settings = await client.app.getAppSettings({ app, lang, preview });
-    console.log(settings);
     const result = {
         name: settings.name,
         description: settings.description,

package/dist/tools/kintone/record/add-record-comment.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const mentionSchema = z.object({
+    code: z
+        .string()
+        .describe("Login name (for USER), group/role code (for GROUP), or organization code (for ORGANIZATION). Display names are not accepted."),
+    type: z
+        .enum(["USER", "GROUP", "ORGANIZATION"])
+        .describe("Type of the mention target"),
+});
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app that contains the record (numeric value as string)"),
+    record: z.string().describe("The ID of the record to add a comment to"),
+    text: z
+        .string()
+        .min(1)
+        .max(65535)
+        .describe("Comment text. To mention users/groups/organizations, list the corresponding entries in 'mentions'. Do NOT include '@code' tokens in this text — not even as a greeting prefix such as '@user1 さん、' or '@group_name '. Mentions specified via the 'mentions' parameter are auto-rendered into the posted comment by kintone; any '@code' written in this text becomes a plain-text literal that does not link, does not notify, and visually duplicates the auto-rendered mention."),
+    mentions: z
+        .array(mentionSchema)
+        .optional()
+        .describe("Mentions to attach to the comment. Each entry pairs a code with its type (USER/GROUP/ORGANIZATION)."),
+};
+const outputSchema = {
+    id: z.string().describe("ID of the added comment"),
+};
+const toolName = "kintone-add-record-comment";
+const toolConfig = {
+    title: "Add Record Comment",
+    description: "Add a single comment to a kintone record. The kintone API accepts one comment per call; to add comments to multiple records, call this tool repeatedly.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, record, text, mentions }, { client }) => {
+    const response = await client.record.addRecordComment({
+        app,
+        record,
+        comment: {
+            text,
+            mentions,
+        },
+    });
+    const result = {
+        id: response.id,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const addRecordComment = createTool(toolName, toolConfig, callback);

package/dist/tools/kintone/record/get-record-comments.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+const inputSchema = {
+    app: z
+        .string()
+        .describe("The ID of the app that contains the record (numeric value as string)"),
+    record: z.string().describe("The ID of the record to retrieve comments from"),
+    order: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Sort order of comments by createdAt. 'asc' = oldest first, 'desc' = newest first (default: desc)"),
+    limit: z
+        .number()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("Maximum number of comments to retrieve (1-10, default: 10 by kintone API)"),
+    offset: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Number of comments to skip (default: 0)"),
+};
+const commentSchema = z.object({
+    id: z.string().describe("Comment ID"),
+    text: z.string().describe("Comment text"),
+    createdAt: z.string().describe("Comment creation datetime (ISO 8601)"),
+    creator: z
+        .object({
+        code: z.string().describe("User code of the comment creator"),
+        name: z.string().describe("Display name of the comment creator"),
+    })
+        .describe("Information about the comment creator"),
+    mentions: z
+        .array(z.object({
+        code: z.string().describe("Code of the mentioned user/group/org"),
+        type: z
+            .enum(["USER", "GROUP", "ORGANIZATION"])
+            .describe("Type of the mention target"),
+    }))
+        .describe("Mentions in the comment"),
+});
+const outputSchema = {
+    comments: z.array(commentSchema).describe("Array of comments on the record"),
+    older: z
+        .boolean()
+        .describe("Whether there are older comments beyond this page"),
+    newer: z
+        .boolean()
+        .describe("Whether there are newer comments beyond this page"),
+};
+const toolName = "kintone-get-record-comments";
+const toolConfig = {
+    title: "Get Record Comments",
+    description: "Get comments posted on a single kintone record. The kintone API returns comments for one record at a time; to fetch comments for multiple records, call this tool repeatedly. Up to 10 comments are returned per call; use offset to paginate.",
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ app, record, order, limit, offset }, { client }) => {
+    const response = await client.record.getRecordComments({
+        app,
+        record,
+        order,
+        limit,
+        offset,
+    });
+    const result = {
+        comments: response.comments,
+        older: response.older,
+        newer: response.newer,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const getRecordComments = createTool(toolName, toolConfig, callback);

package/dist/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated. Do not edit manually.
-export const version = "1.4.0"; // x-release-please-version
+export const version = "1.5.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kintone/mcp-server",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -31,7 +31,7 @@
   ],
   "dependencies": {
     "@kintone/rest-api-client": "6.2.0",
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "file-type": "22.0.1",
     "https-proxy-agent": "7.0.6",
     "zod": "3.25.76"
@@ -48,7 +48,7 @@
     "eslint": "9.39.4",
     "eslint-plugin-package-json": "0.88.3",
     "globals": "17.6.0",
-    "npm": "11.15.0",
+    "npm": "11.16.0",
     "prettier": "3.8.3",
     "tsx": "4.22.3",
     "typescript": "5.9.3",