@kintone/mcp-server 1.4.0 → 1.6.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [1.6.0](https://github.com/kintone/mcp-server/compare/1.5.0...1.6.0) (2026-06-23)
+
+
+### Features
+
+* add get space tool ([#435](https://github.com/kintone/mcp-server/issues/435)) ([24fe1a9](https://github.com/kintone/mcp-server/commit/24fe1a9a64e2cacd2dfd8e58baf6f8c5f36faa90))
+
+## [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,10 +209,13 @@ 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` | アプリの一般設定を変更                 |
 | `kintone-download-file`           | 添付ファイルフィールドのファイルを保存 |
+| `kintone-get-space`               | スペースの情報を取得                   |
 
 ## ドキュメント
 

package/dist/schema/space/index.js

@@ -0,0 +1 @@
+export { spaceSchema } from "./space.js";

package/dist/schema/space/space.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+const userRefSchema = z.object({
+    code: z.string().describe("User login name (unique identifier)"),
+    name: z.string().describe("Display name of the user"),
+});
+const permissionsSchema = z.object({
+    createApp: z
+        .enum(["EVERYONE", "ADMIN"])
+        .describe("Who may create apps in this space: EVERYONE (any member) or ADMIN (space administrators only)"),
+});
+const attachedAppSchema = z.object({
+    threadId: z
+        .string()
+        .nullable()
+        .describe("Thread ID where the app is placed; null when not associated with a thread per API response"),
+    appId: z.string().describe("Numeric app ID as string"),
+    code: z.string().describe("App code (unique string)"),
+    name: z.string().describe("App name"),
+    description: z.string().describe("App description"),
+    createdAt: z.string().describe("App creation datetime (ISO 8601)"),
+    creator: userRefSchema.describe("User who created the app"),
+    modifiedAt: z.string().describe("App last modified datetime (ISO 8601)"),
+    modifier: userRefSchema.describe("User who last modified the app"),
+});
+export const spaceSchema = z.object({
+    id: z.string().describe("The space ID"),
+    name: z.string().describe("The space name"),
+    defaultThread: z
+        .string()
+        .describe("Thread ID of the default thread in this space"),
+    isPrivate: z.boolean().describe("Whether the space is private"),
+    creator: userRefSchema.describe("User who created the space"),
+    modifier: userRefSchema.describe("User who last modified the space"),
+    memberCount: z
+        .string()
+        .describe("Member count returned by the API (stringified number)"),
+    coverType: z
+        .enum(["BLOB", "PRESET"])
+        .describe("Cover image type: BLOB (custom upload) or PRESET (preset image)"),
+    coverKey: z.string().describe("Key of the cover image"),
+    coverUrl: z.string().describe("URL of the cover image"),
+    body: z
+        .string()
+        .nullable()
+        .describe("HTML body of the space portal; null when the portal has no content"),
+    useMultiThread: z.boolean().describe("Whether multiple threads are enabled"),
+    isGuest: z.boolean().describe("Whether the space is a guest space"),
+    attachedApps: z
+        .array(attachedAppSchema)
+        .describe("Apps attached to this space"),
+    fixedMember: z
+        .boolean()
+        .describe("Whether users are blocked from joining or leaving on their own"),
+    showAnnouncement: z
+        .boolean()
+        .nullable()
+        .describe("Announcement widget visibility; null for single-thread spaces where not applicable"),
+    showThreadList: z
+        .boolean()
+        .nullable()
+        .describe("Thread list widget visibility; null for single-thread spaces where not applicable"),
+    showAppList: z
+        .boolean()
+        .nullable()
+        .describe("App list widget visibility; null for single-thread spaces where not applicable"),
+    showMemberList: z
+        .boolean()
+        .nullable()
+        .describe("Member list widget visibility; null for single-thread spaces where not applicable"),
+    showRelatedLinkList: z
+        .boolean()
+        .nullable()
+        .describe("Related apps and spaces widget visibility; null for single-thread spaces where not applicable"),
+    permissions: permissionsSchema.describe("Space permission settings"),
+});

package/dist/server/tool-filters.js

@@ -1,7 +1,12 @@
 const filterRules = [
     {
         condition: (condition) => condition.isApiTokenAuth,
-        excludeTools: ["kintone-get-apps", "kintone-add-app", "kintone-search"],
+        excludeTools: [
+            "kintone-get-apps",
+            "kintone-add-app",
+            "kintone-search",
+            "kintone-get-space",
+        ],
     },
 ];
 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 { getSpace } from "./kintone/space/get-space.js";
 import { search } from "./kintone/search/search.js";
 export { createToolCallback } from "./factory.js";
 export const tools = [
@@ -36,10 +39,13 @@ export const tools = [
     addRecords,
     deleteRecords,
     getRecords,
+    getRecordComments,
+    addRecordComment,
     updateRecords,
     addApp,
     deployApp,
     updateGeneralSettings,
     downloadFile,
+    getSpace,
     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/space/get-space.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { createTool } from "../../factory.js";
+import { spaceSchema } from "../../../schema/space/index.js";
+const inputSchema = {
+    id: z
+        .string()
+        .describe("Space ID as returned by Kintone (numeric string). Same value as in space URLs and other Space APIs."),
+};
+const outputSchema = spaceSchema.shape;
+const toolName = "kintone-get-space";
+const toolDescription = "Retrieve a kintone space via the Space REST API (GET /k/v1/space.json). " +
+    "Read-only: returns metadata and portal content such as name, default thread, privacy, HTML body, cover image, " +
+    "widget visibility, member count, attached apps, and who may create apps (EVERYONE vs ADMIN). " +
+    "Requires permission to view the target space. Does not modify any space configuration.";
+const toolConfig = {
+    title: "Get Space",
+    description: toolDescription,
+    inputSchema,
+    outputSchema,
+};
+const callback = async ({ id }, { client }) => {
+    const space = await client.space.getSpace({ id });
+    const result = {
+        id: space.id,
+        name: space.name,
+        defaultThread: space.defaultThread,
+        isPrivate: space.isPrivate,
+        creator: space.creator,
+        modifier: space.modifier,
+        memberCount: space.memberCount,
+        coverType: space.coverType,
+        coverKey: space.coverKey,
+        coverUrl: space.coverUrl,
+        body: space.body,
+        useMultiThread: space.useMultiThread,
+        isGuest: space.isGuest,
+        attachedApps: space.attachedApps,
+        fixedMember: space.fixedMember,
+        showAnnouncement: space.showAnnouncement,
+        showThreadList: space.showThreadList,
+        showAppList: space.showAppList,
+        showMemberList: space.showMemberList,
+        showRelatedLinkList: space.showRelatedLinkList,
+        permissions: space.permissions,
+    };
+    return {
+        structuredContent: result,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+};
+export const getSpace = 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.6.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kintone/mcp-server",
-  "version": "1.4.0",
+  "version": "1.6.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"
@@ -43,16 +43,16 @@
     "@cybozu/eslint-config": "25.0.1",
     "@cybozu/license-manager": "1.4.1",
     "@modelcontextprotocol/inspector": "0.18.0",
-    "@types/node": "22.19.19",
-    "doctoc": "2.4.1",
+    "@types/node": "22.20.0",
+    "doctoc": "2.5.0",
     "eslint": "9.39.4",
     "eslint-plugin-package-json": "0.88.3",
     "globals": "17.6.0",
-    "npm": "11.15.0",
-    "prettier": "3.8.3",
-    "tsx": "4.22.3",
+    "npm": "11.17.0",
+    "prettier": "3.8.4",
+    "tsx": "4.22.4",
     "typescript": "5.9.3",
-    "vitest": "4.1.7"
+    "vitest": "4.1.9"
   },
   "engines": {
     "node": ">= 22"