日本語 🇯🇵

@growi/mcp-server

A Model Context Protocol (MCP) server that connects AI models to GROWI wiki content. Enables LLMs to search and retrieve information from your organization's knowledge base for accurate, context-aware responses. Supports connections to multiple GROWI apps.

Key Features

🔍 GROWI page search and retrieval
📝 Page management
🏷️ Tag management
📋 Comment management
🔗 Share link management

Supported GROWI Versions

GROWI v7.3.x or higher recommended
Some features are also available starting from GROWI v7.2.5 and later
GROWI API

Agent Skills

This repository also provides Agent Skills — reusable workflow definitions that AI coding agents can load to interact with GROWI more effectively.

Available Skills

growi-mcp-setup — Walks you through setting up the GROWI MCP server. After the skill is installed, it guides you from configuring UTCP Code-Mode through verifying the connection.
growi-smart-save — Save content to GROWI with intelligent path suggestions. The agent calls the suggest-path tool, presents destination candidates, and guides the user through page naming and visibility settings.

Quick Start (Recommended)

The fastest way to start using GROWI. Once you install the skill, the rest of the setup (connecting the MCP server, configuring UTCP Code-Mode, verifying connectivity) is guided by the AI agent.

1. Install the Skill

Install the skill for your agent.

Claude Desktop (Cowork)

Go to Customize > Personal Plugins (click the + icon)
Click Browse Plugins > select the Personal tab
Click the + icon next to Local Upload
Select Add marketplace from GitHub
Enter the repository URL and click Sync:

hljs language-arduino

https://github.com/growilabs/growi-mcp-server

Claude Code

Add this repository as a plugin marketplace, then install the plugin:

hljs language-bash

/plugin marketplace add growilabs/growi-mcp-server
/plugin install mcp-client-skills

Gemini CLI

Install as a Gemini CLI extension (includes both MCP tools and skills):

hljs language-bash

gemini extensions install https://github.com/growilabs/growi-mcp-server

Update with:

hljs language-bash

gemini extensions update growi-mcp-server

Skills.sh (Vercel)

Works with Claude Code, Gemini CLI, Cursor, Codex, GitHub Copilot, and many other agents:

hljs language-bash

npx skills add growilabs/growi-mcp-server

Update with:

hljs language-bash

npx skills update

Manual Installation

Download skills directly from the repository and place them in your agent's skills directory:

Copy the desired skill directory from skills/ in this repository
Place it in your agent's skills directory:
- Claude Code: .claude/skills/<skill-name>/SKILL.md
- Gemini CLI: .gemini/skills/<skill-name>/SKILL.md
- Other agents: .agents/skills/<skill-name>/SKILL.md

2. Restart Your Agent

After installation, restart (or reload) your agent so the skill is recognized.

3. Ask the AI to Set Up

Tell your agent "set up GROWI", and the growi-mcp-setup skill will start and guide you from the MCP server connection settings through verifying connectivity.

[!NOTE] If you want to configure the MCP server directly without the skill, see Use the MCP Server Directly.

Use the MCP Server Directly

You can also register the MCP server directly with your agent instead of using the skill. Use this for a minimal setup, or as a fallback when skill-based setup is not available.

Supports simultaneous connections to multiple GROWI apps. Each app is configured using numbered environment variables.

Single App Configuration Example

hljs language-json

{
  "mcpServers": {
    "growi": {
      "command": "npx",
      "args": ["@growi/mcp-server"],
      "env": {
        "GROWI_APP_NAME_1": "main",
        "GROWI_BASE_URL_1": "https://your-growi-instance.com",
        "GROWI_API_TOKEN_1": "your_growi_api_token"
      }
    }
  }
}

Multiple Apps Configuration Example

hljs language-json

{
  "mcpServers": {
    "growi": {
      "command": "npx",
      "args": ["@growi/mcp-server"],
      "env": {
        "GROWI_DEFAULT_APP_NAME": "staging",

        "GROWI_APP_NAME_1": "production",
        "GROWI_BASE_URL_1": "https://wiki.example.com",
        "GROWI_API_TOKEN_1": "token_for_production",

        "GROWI_APP_NAME_2": "staging",
        "GROWI_BASE_URL_2": "https://wiki-staging.example.com",
        "GROWI_API_TOKEN_2": "token_for_staging",

        "GROWI_APP_NAME_3": "development",
        "GROWI_BASE_URL_3": "https://wiki-dev.example.com",
        "GROWI_API_TOKEN_3": "token_for_development"
      }
    }
  }
}

[!TIP] For skill-based setup (recommended), see Quick Start.

Available Tools (Features)

Page Management

searchPages - Search pages by keywords
createPage - Create a new page
updatePage - Update an existing page
deletePages - Delete pages (bulk operation supported)
duplicatePage - Duplicate a page (including child pages)
renamePage - Change page name and path
getPage - Get a page data
getPageInfo - Get detailed page information
getRecentPages - Get list of recently updated pages
getPageListingRoot - Get root page list
getPageListingChildren - Get child pages of specified page
pageListingInfo - Get summary information of page listings
publishPage / unpublishPage - Set page publish/unpublish status

Tag Management

getPageTag - Get tags of a page
updateTag - Update tags of a page
getTagList - Get list of tags
searchTags - Search tags

Comments & Discussions

getComments - Get comments of a page

Revision Management

listRevisions - Get page edit history
getRevision - Get details of a specific revision

Share Links

createShareLink - Create a share link
getShareLinks - Get share links of a page
deleteShareLinks - Delete share links
deleteShareLinkById - Delete a specific share link

User Information

getUserRecentPages - Get recent pages of a specific user

Configuration Options

Environment Variables

Variable Name	Required	Description	Default Value
`GROWI_APP_NAME_{N}`	✅	GROWI app identifier name (N is an integer)	-
`GROWI_BASE_URL_{N}`	✅	Base URL of GROWI instance (N is an integer)	-
`GROWI_API_TOKEN_{N}`	✅	GROWI API access token (N is an integer)	-
`GROWI_DEFAULT_APP_NAME`	❌	Default app name to use	First configured app

Multiple Apps Configuration Notes

Use integer values (1, 2, 3...) for each app configuration (sequential numbering is not required)
Combination of GROWI_APP_NAME_N, GROWI_BASE_URL_N, and GROWI_API_TOKEN_N is required
App names, base URLs, and API tokens must each be unique
If GROWI_DEFAULT_APP_NAME is omitted, the first configured app becomes the default
The app specified in GROWI_DEFAULT_APP_NAME will be used as the default app when the LLM does not explicitly include an app name in the prompt

Developer Information

Requirements

Node.js 18 or higher
pnpm (recommended)
GROWI instance (for development and testing)

Getting Started

Clone the repository

hljs language-bash

git clone https://github.com/growilabs/growi-mcp-server.git
cd growi-mcp-server

Install dependencies

hljs language-bash

pnpm install

Set up environment variables

hljs language-bash

cp .env.example .env.local
# Edit .env.local to enter GROWI connection information

Start the development server

hljs language-bash

# Test with MCP CLI
pnpm dev:cli

# Develop with MCP Inspector
pnpm dev:inspect

Build and Test

hljs language-bash

# Build
pnpm build

# Lint
pnpm lint

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

# Run in production
pnpm start

MCP Server Configuration

Build

hljs language-bash

pnpm build

MCP Server Configuration (Single App)

hljs language-json

{
  "mcpServers": {
    "growi": {
      "command": "node",
      "args": ["/Users/username/projects/growi-mcp-server/dist/index.js"],
      "env": {
        "GROWI_APP_NAME_1": "main",
        "GROWI_BASE_URL_1": "https://your-growi-instance.com",
        "GROWI_API_TOKEN_1": "your_growi_api_token"
      }
    }
  }
}

MCP Server Configuration (Multiple Apps)

hljs language-json

{
  "mcpServers": {
    "growi": {
      "command": "node",
      "args": ["/Users/username/projects/growi-mcp-server/dist/index.js"],
      "env": {
        "GROWI_DEFAULT_APP_NAME": "production",

        "GROWI_APP_NAME_1": "production",
        "GROWI_BASE_URL_1": "https://wiki.example.com",
        "GROWI_API_TOKEN_1": "production_token",

        "GROWI_APP_NAME_2": "staging",
        "GROWI_BASE_URL_2": "https://wiki-staging.example.com",
        "GROWI_API_TOKEN_2": "staging_token"
      }
    }
  }
}

[!NOTE] Set the absolute path to the built output in "args"

Troubleshooting

When unable to connect to GROWI

Check connectivity

hljs language-bash

curl -v http://app:3000/_api/v3/healthcheck

If the app hostname cannot be resolved, check the devcontainer network and verify it includes growi_devcontainer_default
- The .devcontainer/devcontainer.json file sets --network in runArgs, so rebuilding the container should apply this setting
- To add manually, run the following:
  - Run docker network command on the docker host machine
  hljs language-bash
```
docker network connect growi_devcontainer_default growi-mcp-server-dev
```

Contributing

Contributions to the project are welcome!

How to Contribute

Issue Reports: Bug reports and feature requests via GitHub Issues
Pull Requests:
- Fork and create a branch
- Implement changes
- Add tests (if applicable)
- Create a pull request

Development Guidelines

Coding Standards: Use Biome
Commit Messages: Follow Conventional Commits

License

This project is released under the MIT License.

growi-mcp-server

@growi/mcp-server

Key Features

Supported GROWI Versions

Agent Skills

Available Skills

Quick Start (Recommended)

1. Install the Skill

Claude Desktop (Cowork)

Claude Code

Gemini CLI

Skills.sh (Vercel)

Manual Installation

2. Restart Your Agent

3. Ask the AI to Set Up

Use the MCP Server Directly

Single App Configuration Example

Multiple Apps Configuration Example

Available Tools (Features)

Page Management

Tag Management

Comments & Discussions

Revision Management

Share Links

User Information

Configuration Options

Environment Variables

Multiple Apps Configuration Notes

Developer Information

Requirements

Getting Started

Build and Test

MCP Server Configuration

Troubleshooting

When unable to connect to GROWI

Contributing

How to Contribute

Development Guidelines

License

Related Links

Similar Packages

Security

Repository

Original Author

Publisher

Repository