The Tiptap Collaboration MCP Server provides a Model Context Protocol (MCP) interface for comprehensive management and interaction with collaborative documents in the Tiptap ecosystem.
Health & Statistics: Check collaboration service health (DB, Redis, License status), retrieve server-wide usage statistics (total documents, connections, concurrent users, version info), and monitor real-time document activity and connected IPs.
Document Management: Create, retrieve, list, update, and delete collaborative documents with optional initial content and flexible content modification (replace or append).
Advanced Document Operations: Duplicate existing documents, encrypt document content using Base64, and perform semantic search across documents (requires Tiptap Semantic Search).
Content Conversion: Convert between Markdown and Tiptap JSON formats bidirectionally.
Batch Operations: Import multiple documents in bulk using predefined JSON structure for efficient mass document creation.
Tiptap Collaboration MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.
Tools Available
Health & Statistics
get-collaboration-health
Check the health status of the Tiptap collaboration service.
- Parameters: None
- Returns: Health status information (DB, Redis, License status)
get-server-statistics
Get server-wide usage statistics.
- Parameters: None
- Returns: Total documents, connections, concurrent users, version info
get-document-statistics
Get real-time statistics for a specific document.
- Parameters:
id
(string): Document ID
- Returns: Current connections, connected IPs, document activity
Document Management
create-document
Create a new collaborative document.
- Parameters:
name
(string): Name of the documentcontent
(object, optional): Initial content for the document in Tiptap JSON format
- Returns: Created document information
get-document
Retrieve information about a specific collaborative document.
- Parameters:
id
(string): ID of the document to retrieve
- Returns: Document information and content
list-documents
List all available collaborative documents.
- Parameters: None
- Returns: Array of all documents in the system
update-document
Update a collaborative document with new content.
- Parameters:
id
(string): Document IDcontent
(object): Document content in Tiptap JSON formatmode
(string, optional): Update mode - "replace" or "append" (default: "replace")
- Returns: Updated document information
delete-document
Delete a collaborative document.
- Parameters:
id
(string): ID of the document to delete
- Returns: Deletion confirmation
Advanced Document Operations
duplicate-document
Duplicate an existing collaborative document.
- Parameters:
sourceId
(string): ID of the source document to duplicatetargetId
(string): ID for the new duplicated document
- Returns: Duplicated document information
encrypt-document
Encrypt a collaborative document using Base64 encryption.
- Parameters:
id
(string): Document IDcontent
(object): Document content in Tiptap JSON format to encrypt
- Returns: Encryption confirmation
search-documents
Search documents using semantic search (requires Tiptap Semantic Search).
- Parameters:
query
(string): Search querylimit
(number, optional): Maximum results to return (default: 10)
- Returns: Array of matching documents with relevance scores
Markdown Conversion
import-markdown
Convert Markdown content to Tiptap JSON format.
- Parameters:
appId
(string): Your Tiptap App ID for the conversion servicecontent
(string): Markdown content to convertformat
(string, optional): "md" or "gfm" (GitHub Flavored Markdown, default: "md")
- Returns: Converted Tiptap JSON content
export-markdown
Convert Tiptap JSON content to Markdown format.
- Parameters:
appId
(string): Your Tiptap App ID for the conversion servicecontent
(object): Tiptap JSON content to convertformat
(string, optional): "md" or "gfm" (GitHub Flavored Markdown, default: "md")
- Returns: Converted Markdown content
Batch Operations
batch-import-documents
Import multiple documents in bulk using a predefined JSON structure.
- Parameters:
documents
(array): Array of document arrays, where each inner array represents versions of a single document
- Returns: Import results for all documents
Installation
Configuration
The server requires both a BASE_URL and API_TOKEN to connect to your Tiptap collaboration service.
Required Parameters
BASE_URL (Required)
The base URL of your Tiptap collaboration service. This parameter is required and the server will exit if not provided.
API_TOKEN (Recommended)
API token for authentication with the Tiptap collaboration service. While not strictly required, most operations will fail without proper authentication.
Command Line Usage
Host Usage
Add this server to your Claude, Windsurf, or any other host with the relevant syntax. An example:
Resources
License
This project is licensed under the MIT License - see the LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables interaction with Tiptap collaborative document services through comprehensive document management, real-time statistics, markdown conversion, and batch operations. Supports creating, updating, searching, and managing collaborative documents with health monitoring and semantic search capabilities.
Related MCP Servers
- -securityFlicense-qualityProvides API tools to interact with Yonote documents and collections, serving as an alternative to Notion with capabilities to list documents/collections and retrieve detailed document information.Last updated -2
- -securityAlicense-qualityEnables interaction with BookStack knowledge management systems through the BookStack API. Supports searching, reading, creating, and updating documentation content with secure authentication and dual transport modes for flexible deployment.Last updated -MIT License
- -securityAlicense-qualityEnables AI-powered querying and management of documentation through markdown file serving, keyword search, and OpenAI-based Q\&A capabilities. Supports document indexing, analysis, and agent handoffs with rate limiting protection.Last updated -5MIT License
- -securityAlicense-qualityTransforms any website's documentation into an MCP-compatible interactive knowledge base with universal scraping, advanced search, and AI-powered tools. Supports GitBook, Notion, Confluence, and custom documentation platforms with real-time synchronization.Last updated -2MIT License