Docmost MCP Server
An MCP (Model Context Protocol) server that provides access to Docmost REST APIs as MCP tools.
Features
- Implements Docmost REST APIs as MCP tools
- Supports both stdio and HTTP transports
- Server-side credential configuration
- Complete API coverage for Spaces, Pages, Users, Workspaces, Comments, Groups, and Search
Installation```bash
go build -o docmost-mcp ./cmd/server
### Docker```bash
docker build -t docmost-mcp .
docker run -e DOCMOST_URL=https://docmost.example.com -e DOCMOST_USER=admin -e DOCMOST_PASS=your_password -p 8080:8080 docmost-mcp
Usage
Command Line Options```bash
./docmost-mcp [options]
Options:
- `-transport` - Transport type: `stdio` (default) or `http`
- `-port` - HTTP server port (default: `8080`, only used with http transport)
- `-docmost-url` - Docmost server URL (required, or set `DOCMOST_URL` env var)
- `-docmost-user` - Docmost username (required, or set `DOCMOST_USER` env var)
- `-docmost-pass` - Docmost password (required, or set `DOCMOST_PASS` env var)
### Examples
#### Stdio Transport (for MCP clients)```bash
export DOCMOST_PASS=your_password
./docmost-mcp -transport stdio -docmost-url https://docmost.example.com -docmost-user admin
HTTP Transport```bash
export DOCMOST_PASS=your_password
./docmost-mcp -transport http -port 8080 -docmost-url https://docmost.example.com
## Available Tools
### Space Tools
- `spaces_list` - List all spaces
- `space_info` - Get space information
- `space_create` - Create a new space
- `space_update` - Update a space
- `space_delete` - Delete a space
- `space_members` - Get space members
- `space_members_add` - Add members to a space
- `space_members_remove` - Remove a member from a space
- `space_members_change_role` - Change member role in a space
### User Tools
- `user_me` - Get current user information
- `user_update` - Update user information
### Workspace Tools
- `workspace_info` - Get workspace information
- `workspace_public` - Get public workspace information
- `workspace_members` - Get workspace members
- `workspace_update` - Update workspace settings
- `workspace_members_change_role` - Change workspace member role
- `workspace_invites` - Get workspace invites
- `workspace_invites_create` - Create workspace invites
- `workspace_invites_resend` - Resend workspace invite
- `workspace_invites_revoke` - Revoke workspace invite
- `workspace_invites_info` - Get workspace invite information
### Page Tools
- `page_create` - Create a new page
- `page_info` - Get page information
- `page_update` - Update a page
- `page_delete` - Delete a page
- `page_move` - Move a page
- `page_sidebar_pages` - Get sidebar pages
- `page_breadcrumbs` - Get page breadcrumbs
- `page_recent` - Get recent pages
- `page_export` - Export a page (html/markdown)
- `page_history` - Get page history
- `page_history_info` - Get page history information
### Comment Tools
- `comment_create` - Create a comment
- `comment_list` - List comments for a page
- `comment_info` - Get comment information
- `comment_update` - Update a comment
- `comment_delete` - Delete a comment
- `comment_resolve` - Resolve or unresolve a comment
### Group Tools
- `group_list` - List groups
- `group_info` - Get group information
- `group_create` - Create a group
- `group_update` - Update a group
- `group_delete` - Delete a group
- `group_members` - Get group members
- `group_members_add` - Add members to a group
- `group_members_remove` - Remove a member from a group
### Search Tools
- `search` - Search for content
- `search_suggest` - Get search suggestions
## Extending
To add more Docmost API endpoints:
1. Add input struct types in `internal/mcp/tools.go` or create a new file
2. Add tool registration using `mcp.AddTool()` in the appropriate `register*Tools()` function
3. Follow the existing pattern for API calls
Example:```go
type CommentCreateInput struct {
Content string `json:"content" jsonschema:"description:Comment content,required"`
PageID string `json:"page_id" jsonschema:"description:Page ID,required"`
}
func (s *Server) registerCommentTools() {
mcp.AddTool(s.server, &mcp.Tool{
Name: "comment_create",
Description: "Create a comment",
}, func(ctx context.Context, req *mcp.CallToolRequest, input CommentCreateInput) (*mcp.CallToolResult, Output, error) {
client := s.getClientFromArgs(map[string]any{})
body := url.Values{}
body.Set("content", input.Content)
body.Set("pageId", input.PageID)
resp, err := client.post("/comments/create", body, nil)
if err != nil {
return nil, Output{}, err
}
return nil, Output{Text: string(resp)}, nil
})
}
API Reference
See the Docmost API Postman Collection for complete API documentation.
A local copy is also available at docmost-api/Docmost API.postman_collection.json.
License
MIT
