@kintone/mcp-server 1.3.15 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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/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

@@ -18,6 +18,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,
@@ -40,4 +41,5 @@ export const tools = [
     deployApp,
     updateGeneralSettings,
     downloadFile,
+    search,
 ];

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.4.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kintone/mcp-server",
-  "version": "1.3.15",
+  "version": "1.4.0",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -30,7 +30,7 @@
     "dist"
   ],
   "dependencies": {
-    "@kintone/rest-api-client": "6.1.7",
+    "@kintone/rest-api-client": "6.2.0",
     "@modelcontextprotocol/sdk": "1.26.0",
     "file-type": "22.0.1",
     "https-proxy-agent": "7.0.6",