@kintone/mcp-server 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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)
 
 

package/README.md

@@ -215,6 +215,7 @@ export HTTPS_PROXY="http://username:password@proxy.example.com:8080"
 | `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

@@ -20,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 = [
@@ -45,5 +46,6 @@ export const tools = [
     deployApp,
     updateGeneralSettings,
     downloadFile,
+    getSpace,
     search,
 ];

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.5.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.5.0",
+  "version": "1.6.0",
   "description": "The official MCP Server for kintone",
   "keywords": [
     "kintone",
@@ -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.16.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"