README.md•2.62 kB
# Quip MCP Server
A Model Context Protocol (MCP) server for Quip document operations that enables direct interaction with Quip documents from AI assistants like Claude.
## Features
- **Read Documents**: Fetch and display Quip document content by ID
- **Append Content**: Add content to the end of existing documents
- **Prepend Content**: Add content to the beginning of documents
- **Replace Content**: Update document content
- **Create Documents**: Intended support for creating new documents (currently redirects to web interface)
## How It Works
This MCP server acts as a bridge between Claude and Quip documents. It works by:
1. Receiving requests from Claude through the MCP protocol
2. Executing a Python script (`quip_edit_fixed.py`) with the appropriate parameters
3. Returning the results back to Claude
## Prerequisites
- Node.js v18 or higher
- TypeScript
- Python with `quip` library installed
- A valid Quip access token
## Installation
1. Clone this repository:
```
git clone https://github.com/AvinashBole/quip-mcp-server.git
cd quip-mcp-server
```
2. Install dependencies:
```
npm install
```
3. Build the project:
```
npm run build
```
4. Configure your MCP settings:
```json
{
"mcpServers": {
"quip": {
"command": "node",
"args": ["path/to/quip-server/build/index.js"],
"env": {
"QUIP_ACCESS_TOKEN": "your-quip-access-token",
"QUIP_BASE_URL": "https://platform.quip.com"
},
"disabled": false,
"autoApprove": []
}
}
}
```
## Usage
Once connected, the following MCP tools become available to Claude:
- `quip_read_document`: Read a Quip document by its thread ID
- `quip_append_content`: Append content to a document
- `quip_prepend_content`: Add content to the beginning of a document
- `quip_replace_content`: Replace document content
- `quip_create_document`: Create a new document (currently unsupported)
Example usage in Claude:
```
<use_mcp_tool>
<server_name>quip</server_name>
<tool_name>quip_read_document</tool_name>
<arguments>
{
"threadId": "YOUR_DOCUMENT_ID"
}
</arguments>
</use_mcp_tool>
```
## Python Script Integration
The server expects a Python script called `quip_edit_fixed.py` in the path specified by the `PYTHON_SCRIPT_PATH` constant. This script should support the following operations:
- `read`: Read document content
- `append`: Add content to the end of a document
- `prepend`: Add content to the beginning of a document
- `replace`: Update document content
## License
ISC License
## Author
AvinashBole