A Model Context Protocol (MCP) server providing AI assistants with comprehensive Quip document access and management. - Full Document Lifecycle: Create, read, edit, delete Quip documents - Smart Search: Find documents with comprehensive search capabilities - Recent Documents: Access your recently viewed/edited documents - User Management: Get user information and details - Comments: Retrieve and m
Add this skill
npx mdskills install bug-breeder/quip-mcpComprehensive MCP server for Quip with excellent documentation and useful document management tools
1# Quip MCP Server23A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server providing AI assistants with comprehensive Quip document access and management.45[](https://cursor.com/en/install-mcp?name=quip-mcp&config=eyJjb21tYW5kIjoicXVpcC1tY3AifQ%3D%3D)67## ✨ Features89- **Full Document Lifecycle**: Create, read, edit, delete Quip documents10- **Smart Search**: Find documents with comprehensive search capabilities11- **Recent Documents**: Access your recently viewed/edited documents12- **User Management**: Get user information and details13- **Comments**: Retrieve and manage document discussions14- **Markdown Support**: Clean markdown formatting throughout15- **Robust API**: Handles complex Quip API response structures16- **Secure**: Token-based authentication with enterprise support1718## 🚀 Quick Install1920### Step 1: Install the binary2122#### One-line install (macOS/Linux)23```bash24curl -sSL https://raw.githubusercontent.com/bug-breeder/quip-mcp/main/install.sh | bash25```2627#### Manual download28Download the appropriate binary for your platform from the [releases page](https://github.com/bug-breeder/quip-mcp/releases).2930### Step 2: Add to Cursor (One-click)31After installing the binary, click the button below to add the MCP server configuration to your Cursor IDE:3233[](https://cursor.com/en/install-mcp?name=quip-mcp&config=eyJjb21tYW5kIjoicXVpcC1tY3AifQ%3D%3D)3435> **Note**: This button only adds the MCP configuration to Cursor. You must install the `quip-mcp` binary first (Step 1).363738## ⚡ Quick Start39401. **Get your API token**41 - Visit your Quip instance: `https://your-company.quip.com/dev/token`42 - Generate a new API token43442. **Configure the server**45 ```bash46 quip-mcp --setup47 ```48493. **Add to your MCP client**50 See the instructions below for your specific client.5152That's it! Your AI assistant can now access your Quip documents.5354## 🔌 MCP Client Configuration5556### Cursor57581. Click the "Add to Cursor" button at the top of this README.592. Alternatively, you can add the server manually in Cursor's settings. Go to `File > Settings > MCP` and add a new server with the following configuration:6061 ```json62 {63 "mcpServers": {64 "quip-mcp": {65 "command": "quip-mcp"66 }67 }68 }69 ```7071### Claude7273You can add the Quip MCP server to Claude using two methods:7475**1. Command Line**7677Open your terminal and run the following command:7879```bash80claude mcp add quip-mcp -- quip-mcp81```8283**2. Configuration File**8485Add the following directly into your claude desktop app's setting or to your `claude_desktop_config.json` file:8687```json88{89 "mcp_servers": [90 {91 "name": "quip-mcp",92 "command": ["quip-mcp"]93 }94 ]95}96```9798### Other Clients99100For other MCP clients, you can typically add a new server in the settings. Use the following configuration:101102```json103{104 "mcpServers": {105 "quip-mcp": {106 "command": "quip-mcp"107 }108 }109}110```111112## 🔄 Updates113114### Quick Update115Update to the latest version with one command:116```bash117curl -sSL https://raw.githubusercontent.com/bug-breeder/quip-mcp/main/install.sh | bash -s -- --update118```119120The update script will:121- ✅ Check your current version122- ✅ Skip update if you already have the latest version123- ✅ Only install if a newer version is available124- ✅ Preserve your existing configuration125126### Check Current Version127```bash128quip-mcp --version129```130131## 🛠️ Available Tools132133| Tool | Description |134|------|-------------|135| `get_recent_threads` | Get your recently viewed/edited documents |136| `search_documents` | Search for documents by keyword or query |137| `get_document` | Retrieve full document content by ID |138| `create_document` | Create new documents with markdown content |139| `edit_document` | Update existing documents (append/prepend/replace) |140| `delete_document` | Delete documents permanently |141| `get_user` | Get current user or specific user information |142| `get_document_comments` | Retrieve document comments and discussions |143144## 📖 Usage Examples145146### Get Recent Documents147```148Show my recent Quip documents149```150151### Search Documents152```153Search for documents about "project planning"154```155156### Read Document Content157```158Get the full content of document V9T5AFuROlBN159```160161### Create New Document162```163Create a document titled "Meeting Notes" with markdown content about today's team meeting164```165166### Edit Existing Document167```168Add a new section to document ABC123 about next week's goals169```170171### Delete Document172```173Delete the test document XYZ789174```175176## ⚙️ Configuration177178### Environment Variable179```bash180export QUIP_API_TOKEN="your-token-here"181quip-mcp182```183184### Configuration File185The server automatically saves your token to:186- Linux/macOS: `~/.config/quip-mcp/config.yaml`187- Windows: `%APPDATA%/quip-mcp/config.yaml`188189### CLI Options190```bash191quip-mcp --help # Show help192quip-mcp --version # Show version193quip-mcp --setup # Interactive token setup194quip-mcp --config # Show current configuration195```196197## 🏢 Company Instances198199This server works with both Quip.com and company-specific instances:200201- **Quip.com**: Standard public Quip202- **Company instances**: `https://your-company.quip.com`203204The API token automatically handles routing to your specific instance.205206## 🔒 Security207208- Tokens are stored with restricted file permissions (0600)209- All API communication uses HTTPS210- No sensitive data is logged211212## 🛡️ Troubleshooting213214### Common Issues215216**"No API token found"**217```bash218# Run interactive setup219quip-mcp --setup220221# Or set environment variable222export QUIP_API_TOKEN="your-token-here"223```224225**"Search not available"**226- Some Quip instances have search disabled227- Use direct document IDs instead228- Extract document ID from Quip URLs: `https://company.quip.com/DOCUMENT_ID/title`229**"Permission denied"**230- Ensure your API token has appropriate permissions231- Check document access levels in Quip232233## 🔧 Development234235### Build from Source236```bash237git clone https://github.com/bug-breeder/quip-mcp.git238cd quip-mcp239make build240```241242### Quality Assurance Workflow243```bash244# Run comprehensive pre-commit checks (recommended before any commit)245make pre-commit246247### Testing248```bash249# Unit tests (mocked)250make test-unit251252# Integration tests (requires QUIP_API_TOKEN)253export QUIP_API_TOKEN="your-token"254make test-integration255256# Run all tests257make test-all258```259260### Development Tools261```bash262make help # Show all available commands263make dev-setup # Install development dependencies264make coverage # Generate test coverage report265```266267## 📄 License268269MIT License - see [LICENSE](LICENSE) file for details.270271## 🤝 Contributing272273Contributions are welcome! Please feel free to submit issues and pull requests.274
Full transparency — inspect the skill content before installing.