# growilabs/growi-mcp-server [Verified] [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/growilabs/growi-mcp-server  
**GitHub Stars:** 19  
**npm Downloads (last month):** 811  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/growilabs-growi-mcp-server

## Description
Official MCP Server to integrate with GROWI APIs.

## Tools
Capabilities this server exposes over MCP:

- **searchPages** — Search pages by keywords
- **createPage** — Create a new page
- **updatePage** — Update an existing page (full-body replace; returns the new revision ID)
- **editPage** — Edit parts of a page with string replacements without sending the whole body (supports dry-run diff preview)
- **deletePages** — Delete pages (bulk operation supported)
- **duplicatePage** — Duplicate a page (including child pages)
- **renamePage** — Change page name and path
- **getPageOutline** — Get the heading outline of a page (heading tree with line ranges and sizes, without the body); also detects setext-style (underline) headings
- **getPageSection** — Read only a part of a page, addressed by heading text or line range
- **getPageWholeContents** — Get the full markdown body of a page
- **getPage** — **Deprecated, will be removed in 2.0.0.** Alias of `getPageWholeContents` kept for backward compatibility; use `getPageOutline`, `getPageSection`, or `getPageWholeContents` instead
- **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
- **getPageTag** — Get tags of a page
- **updateTag** — Update tags of a page
- **getTagList** — Get list of tags
- **searchTags** — Search tags
- **getComments** — Get comments of a page
- **addComment** — Add a comment to a page
- **removeComment** — Remove a comment from a page
- **listRevisions** — Get page edit history (revision bodies are omitted; bodyLength is returned instead)
- **getRevision** — Get details of a specific revision
- **listRevisionChanges** — List the authenticated user's consecutive-edit runs across all pages (requires GROWI v7.5.6 or later)
- **getRevisionDiffs** — Get unified diffs for a batch of revision pairs (requires GROWI v7.5.6 or later)
- **createShareLink** — Create a share link
- **getShareLinks** — Get share links of a page
- **deleteShareLinks** — Delete share links
- **deleteShareLinkById** — Delete a specific share link
- **getUserRecentPages** — Get recent pages of a specific user

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "growi-mcp-server": {
    "command": "npx",
    "args": ["-y","skills"],
    "env": {
      "GROWI_APP_NAME_1": "",
      "GROWI_BASE_URL_1": "",
      "GROWI_API_TOKEN_1": ""
    }
  }
}
```

**Requires environment variables:** `GROWI_APP_NAME_1`, `GROWI_BASE_URL_1`, `GROWI_API_TOKEN_1` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What growilabs/growi-mcp-server MCP server does

The growilabs/growi-mcp-server MCP server connects MCP-compatible agents to GROWI wiki instances. It provides tools for finding pages, reading full Markdown content or selected sections, inspecting page outlines, and retrieving page metadata. Agents can also create, replace, partially edit, duplicate, rename, and delete pages. Bulk deletion is supported.

The server covers related wiki operations beyond page bodies. It can read and update tags, search the tag catalog, add or remove comments, inspect revision history, and create, list, or delete share links. It also exposes page listings, recently updated pages, and user-specific recent pages. The older `getPage` operation remains available as an alias, but is deprecated in favor of the more targeted page-reading tools.

## How it works

The package runs as a local stdio MCP server using npm and communicates with GROWI through its APIs. A configuration can define one GROWI application or several. Each application uses a numbered name, base URL, and API token; an optional default app name selects which configured instance should be used when multiple apps are present.

The growilabs/growi-mcp-server MCP server also includes optional Vault commands for synchronizing a local, read-only git clone of a GROWI Vault, locating that clone, and decoding Vault filenames. These commands use the same application configuration and require Git 2.31 or newer. They are separate from the MCP tool interface but can support local wiki searching workflows.

## Setup and configuration

Install and run the server with:

```bash
npx -y @growi/mcp-server
```

Register that command in the MCP client configuration and provide at least these variables for the first application:

- `GROWI_APP_NAME_1`: the local name assigned to the GROWI application
- `GROWI_BASE_URL_1`: the GROWI instance URL
- `GROWI_API_TOKEN_1`: an API token for authentication

Additional numbered sets can connect to other GROWI applications. The repository documents direct setup as an alternative to installing its setup skill. It also provides skills for guided setup and for saving content with suggested GROWI paths.

## Tools and capabilities

The growilabs/growi-mcp-server MCP server includes capabilities for:

- Searching pages and tags
- Reading complete pages, selected sections, outlines, and page metadata
- Creating, updating, partially editing, duplicating, renaming, and deleting pages
- Listing root pages, child pages, recent pages, and page-listing summaries
- Managing page tags and comments
- Reviewing revisions and obtaining revision diffs
- Creating, listing, and deleting page share links
- Publishing or unpublishing pages, where supported by the available package version

Section reads can use heading text or line ranges. Partial edits support replacement operations and a dry-run diff preview. Revision-change and batch-diff tools require GROWI 7.5.6 or later.

## Limitations and notes

GROWI 7.3.x or later is the recommended server version, while some functionality is available from GROWI 7.2.5 onward. The revision-change and revision-diff operations specifically require GROWI 7.5.6 or newer. Revision listings omit revision bodies and return body lengths instead. The `getPage` tool is deprecated and is scheduled for removal in version 2.0.0; new integrations should use the outline, section, or whole-content operations.

The server requires a configured GROWI endpoint and credential. Multiple application connections use numbered environment-variable groups, so each target must be configured separately. Vault synchronization additionally requires a suitable Git installation.

_Full upstream README: https://allmcps.com/mcp/growilabs-growi-mcp-server/readme_