@kintone/mcp-server 1.3.15 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # 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)
+
+
+### Features
+
+* add search tool ([#440](https://github.com/kintone/mcp-server/issues/440)) ([011538e](https://github.com/kintone/mcp-server/commit/011538e98c8f74ea04fcdb0cd44df61a32332370))
+
 ## [1.3.15](https://github.com/kintone/mcp-server/compare/1.3.14...1.3.15) (2026-05-24)
 
 

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/schema/search/index.js

@@ -0,0 +1,2 @@
+export { searchInputSchema } from "./input.js";
+export { searchOutputSchema } from "./output.js";

package/dist/schema/search/input.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+const searchQuerySchema = z.object({
+    operator: z
+        .enum(["AND", "OR", "NOT"])
+        .describe("Search operator (AND: all keywords match, OR: any keyword matches, NOT: keywords do not match)"),
+    keywords: z
+        .array(z.string())
+        .min(1)
+        .describe("Keywords to search for (at least 1 required)"),
+});
+const searchScopeSchema = z.discriminatedUnion("scope", [
+    z.object({
+        scope: z.literal("SPACE"),
+        ids: z
+            .array(z.union([z.number(), z.string()]))
+            .optional()
+            .nullable()
+            .describe("Space IDs to search in"),
+    }),
+    z.object({
+        scope: z.literal("APP"),
+        ids: z
+            .array(z.union([z.number(), z.string()]))
+            .optional()
+            .nullable()
+            .describe("App IDs to search in"),
+    }),
+    z.object({
+        scope: z.literal("PEOPLE"),
+        codes: z
+            .array(z.string())
+            .optional()
+            .nullable()
+            .describe("People codes to search in"),
+    }),
+    z.object({
+        scope: z.literal("MESSAGE"),
+        codes: z
+            .array(z.string())
+            .optional()
+            .nullable()
+            .describe("Message codes to search in"),
+    }),
+]);
+const searchSortSchema = z.union([
+    z.object({
+        by: z.literal("RELEVANCE").optional().describe("Sort by relevance"),
+        order: z.literal("DESC").optional().describe("Order (only DESC)"),
+    }),
+    z.object({
+        by: z.literal("CREATED_AT").describe("Sort by created date"),
+        order: z
+            .enum(["ASC", "DESC"])
+            .optional()
+            .describe("Sort order (ASC or DESC)"),
+    }),
+]);
+const searchHitTypeSchema = z.enum([
+    "RECORD",
+    "RECORD_COMMENT",
+    "SPACE",
+    "THREAD",
+    "THREAD_COMMENT",
+    "PEOPLE_COMMENT",
+    "MESSAGE_COMMENT",
+    "ATTACHMENT",
+]);
+export const searchInputSchema = {
+    query: z
+        .tuple([searchQuerySchema])
+        .rest(searchQuerySchema)
+        .describe("Search queries (at least 1 required)"),
+    types: z
+        .array(searchHitTypeSchema)
+        .optional()
+        .nullable()
+        .describe("Filter by hit types"),
+    scopes: z
+        .array(searchScopeSchema)
+        .optional()
+        .nullable()
+        .describe("Scopes to search in"),
+    excludeScopes: z
+        .array(searchScopeSchema)
+        .optional()
+        .nullable()
+        .describe("Scopes to exclude from search"),
+    createdAfter: z
+        .string()
+        .optional()
+        .describe("Filter results created after this date (ISO 8601 format)"),
+    createdBefore: z
+        .string()
+        .optional()
+        .describe("Filter results created before this date (ISO 8601 format)"),
+    creators: z
+        .array(z.string())
+        .optional()
+        .nullable()
+        .describe("Filter by creator codes"),
+    sort: searchSortSchema.optional().describe("Sort configuration"),
+    limit: z
+        .number()
+        .min(1)
+        .max(20)
+        .default(20)
+        .describe("Maximum number of results to return"),
+    pageToken: z
+        .string()
+        .optional()
+        .nullable()
+        .describe("Token for pagination. If undefined, null, or empty string, returns the first page. For subsequent pages, specify the nextPageToken from the previous response."),
+};

package/dist/schema/search/output.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+const searchUserSchema = z.object({
+    code: z.string(),
+    name: z.string(),
+});
+const idSchema = z.union([z.number(), z.string()]);
+const searchHitRecordSchema = z.object({
+    appId: idSchema,
+    appName: z.string(),
+    recordId: idSchema,
+    recordTitle: z.string(),
+    createdAt: z.string(),
+    creator: searchUserSchema,
+    matchedFields: z.array(z.object({ code: z.string(), label: z.string() })),
+    spaceId: idSchema.optional(),
+    spaceName: z.string().optional(),
+});
+const searchHitRecordCommentSchema = z.object({
+    appId: idSchema,
+    appName: z.string(),
+    recordId: idSchema,
+    recordTitle: z.string(),
+    commentId: idSchema,
+    createdAt: z.string(),
+    creator: searchUserSchema,
+    spaceId: idSchema.optional(),
+    spaceName: z.string().optional(),
+});
+const searchHitSpaceSchema = z.object({
+    spaceId: idSchema,
+    spaceName: z.string(),
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const searchHitThreadSchema = z.object({
+    spaceId: idSchema,
+    spaceName: z.string(),
+    threadId: idSchema,
+    threadName: z.string(),
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const searchHitThreadCommentSchema = z.object({
+    commentId: idSchema,
+    replyId: idSchema.optional(),
+    spaceId: idSchema,
+    spaceName: z.string(),
+    threadId: idSchema,
+    threadName: z.string(),
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const searchHitPeopleCommentSchema = z.object({
+    commentId: idSchema,
+    replyId: idSchema.optional(),
+    owner: searchUserSchema,
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const searchHitMessageCommentSchema = z.object({
+    commentId: idSchema,
+    recipient: searchUserSchema,
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const attachmentBaseSchema = z.object({
+    fileKey: z.string(),
+    name: z.string(),
+    createdAt: z.string(),
+    creator: searchUserSchema,
+});
+const hitBase = { url: z.string(), snippets: z.array(z.string()) };
+const searchHitSchema = z.union([
+    z.object({
+        ...hitBase,
+        type: z.literal("RECORD"),
+        record: searchHitRecordSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("RECORD_COMMENT"),
+        recordComment: searchHitRecordCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("SPACE"),
+        space: searchHitSpaceSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("THREAD"),
+        thread: searchHitThreadSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("THREAD_COMMENT"),
+        threadComment: searchHitThreadCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("PEOPLE_COMMENT"),
+        peopleComment: searchHitPeopleCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("MESSAGE_COMMENT"),
+        messageComment: searchHitMessageCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({
+            attachedTo: z.literal("RECORD"),
+        }),
+        record: searchHitRecordSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({ attachedTo: z.literal("SPACE") }),
+        space: searchHitSpaceSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({
+            attachedTo: z.literal("THREAD"),
+        }),
+        thread: searchHitThreadSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({
+            attachedTo: z.literal("THREAD_COMMENT"),
+        }),
+        threadComment: searchHitThreadCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({
+            attachedTo: z.literal("PEOPLE_COMMENT"),
+        }),
+        peopleComment: searchHitPeopleCommentSchema,
+    }),
+    z.object({
+        ...hitBase,
+        type: z.literal("ATTACHMENT"),
+        attachment: attachmentBaseSchema.extend({
+            attachedTo: z.literal("MESSAGE_COMMENT"),
+        }),
+        messageComment: searchHitMessageCommentSchema,
+    }),
+]);
+export const searchOutputSchema = {
+    hits: z.array(searchHitSchema).describe("Array of search hits"),
+    nextPageToken: z
+        .string()
+        .nullable()
+        .describe("Token for fetching the next page of results"),
+};

package/dist/server/tool-filters.js

@@ -1,7 +1,7 @@
 const filterRules = [
     {
         condition: (condition) => condition.isApiTokenAuth,
-        excludeTools: ["kintone-get-apps", "kintone-add-app"],
+        excludeTools: ["kintone-get-apps", "kintone-add-app", "kintone-search"],
     },
 ];
 export function shouldEnableTool(toolName, condition) {

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";
@@ -18,6 +20,7 @@ import { addApp } from "./kintone/app/add-app.js";
 import { deployApp } from "./kintone/app/deploy-app.js";
 import { updateGeneralSettings } from "./kintone/app/update-general-settings.js";
 import { downloadFile } from "./kintone/file/download-file.js";
+import { search } from "./kintone/search/search.js";
 export { createToolCallback } from "./factory.js";
 export const tools = [
     getApp,
@@ -35,9 +38,12 @@ export const tools = [
     addRecords,
     deleteRecords,
     getRecords,
+    getRecordComments,
+    addRecordComment,
     updateRecords,
     addApp,
     deployApp,
     updateGeneralSettings,
     downloadFile,
+    search,
 ];

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/tools/kintone/search/search.js

@@ -0,0 +1,32 @@
+import { createTool } from "../../factory.js";
+import { searchInputSchema, searchOutputSchema, } from "../../../schema/search/index.js";
+const toolName = "kintone-search";
+const toolConfig = {
+    title: "Search",
+    description: "Search across kintone for records, spaces, threads, comments, and attachments. " +
+        "Performs a cross-domain full-text search. " +
+        "Requires password or session authentication (not API token).",
+    inputSchema: searchInputSchema,
+    outputSchema: searchOutputSchema,
+};
+const callback = async (input, { client }) => {
+    const { query, ...rest } = input;
+    const response = await client.search({
+        ...rest,
+        query,
+    });
+    const result = {
+        hits: response.hits,
+        nextPageToken: response.nextPageToken,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const search = 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.3.15"; // 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.3.15",
+  "version": "1.5.0",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "dependencies": {
-    "@kintone/rest-api-client": "6.1.7",
-    "@modelcontextprotocol/sdk": "1.26.0",
+    "@kintone/rest-api-client": "6.2.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",