A
licenseA
qualityD
maintenanceA Model Context Protocol server that enables AI assistants like Claude to directly read and edit Quip documents through a set of specialized tools.
5
6
ISC
quip-mcp
by petertilsen
Provides tools to read, search, create, and modify Quip documents, enabling AI assistants to interact with Quip content.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@quip-mcpShow me the content of document ABC123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Quip MCP Server
An MCP (Model Context Protocol) server for interacting with Quip documents. This server enables AI assistants like Amazon Q to read, search, and modify Quip documents through a standardized interface.
Features
Document Operations
Read document content
Search across documents
Create new documents
Append content to documents
Prepend content to documents
Replace document content
Integration Features
MCP protocol support
Configurable logging
Environment-based configuration
Docker support
Related MCP server: Docs MCP Server
Installation
From Source
git clone <repository-url>
cd quip-mcp-server
pip install -e .Development Installation
pip install -e ".[dev]"Requirements
Python 3.8 or higher
Required packages (installed automatically):
strands-agents>=1.3.0
mcp>=1.12.3
python-dotenv>=1.0.0
requests>=2.25.0
uvicorn>=0.23.1
httpx>=0.24.0
starlette>=0.27.0
Configuration
Copy the example environment file:
cp .env.example .envConfigure your environment variables in
.env:
# Quip API credentials
QUIP_ACCESS_TOKEN=your_quip_access_token_here
QUIP_BASE_URL=https://platform.quip-amazon.com
# MCP server configuration
MCP_SERVER_PORT=8080
MCP_SERVER_HOST=localhost
# Logging configuration
LOG_LEVEL=INFO # Options: DEBUG, INFO, WARNING, ERROR, CRITICALUsage
Starting the Server
Using the console script:
quip-mcp-serverUsing Python module:
python -m quip_mcp_serverUsing Docker:
docker-compose upAvailable Tools
The server provides the following MCP tools:
Tool Name | Description | Parameters | Example Usage |
| Read a document's content |
| "Show me the content of the Quip document with thread ID 'ABC123'" |
| Search for documents |
| "Find all Quip documents containing 'project planning'" or "Show me the 5 most recent documents about AWS" |
| Create a new document |
| "Create a new Quip document titled 'Meeting Notes' with content 'Agenda items for today:'" |
| Add content to end |
| "Add 'Action items completed' to the end of document ABC123" |
| Add content to beginning |
| "Insert 'DRAFT:' at the start of document ABC123" |
| Replace document content |
| "Replace the content of document ABC123 with 'Updated project timeline'" |
| Get details of a specific folder |
| "Show me the contents of the Quip folder with ID 'XYZ789'" |
| Get a list of folders |
| "List all my Quip folders" or "Show me details of folders ABC123, XYZ789" |
Example conversations with Amazon Q:
User: "Can you read my latest meeting notes from Quip?"
Q: Let me search for and read your meeting notes document.
[Uses search_documents followed by read_document]
User: "Create a new Quip document for today's sprint planning"
Q: I'll create a new document with a standard sprint planning template.
[Uses create_document with appropriate title and content]
User: "Add today's action items to my project notes"
Q: I'll append the action items to your project document.
[Uses append_content to add new items]Using with Amazon Q
Add the MCP server to Q CLI:
q mcp add quip http://localhost:8080Use in conversations with Q:
@q Use quip___read_document to read the document with ID "ABC123"
@q Search Quip documents for "meeting notes" using quip___search_documentsDevelopment
Project Structure
quip_mcp_server/
├── __init__.py # Package initialization
├── __main__.py # Entry point
├── logging_config.py # Centralized logging configuration
├── quip.py # Core Quip API client
├── quip_edit.py # Document editing functionality
└── strands_agent.py # MCP agent implementation
tests/
├── __init__.py # Test package initialization
├── conftest.py # Test fixtures and configuration
├── test_logging_config.py # Tests for logging configuration
├── test_main.py # Tests for main module
├── test_quip.py # Tests for Quip client
├── test_quip_edit.py # Tests for document editing
└── test_strands_agent.py # Tests for MCP agentRunning Tests
# Install development dependencies
pip install -e ".[dev]"
# Run tests with coverage
pytest
# Generate coverage reports
pytest --cov=quip_mcp_server --cov-report=htmlThe current test suite provides approximately 50% code coverage, focusing on the core functionality. The main module tests are currently skipped as they require more complex mocking.
Docker Build
docker build -t quip-mcp-server .License
Apache 2.0
Related MCP Connectors
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Team docs served to AI agents over MCP - search, Markdown reads, version pinning, read audit.
MCP-native collaborative markdown editor with real-time AI document editing
Let AI agents query data and act across all your business apps via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to interact with collaborative Docs instances, providing document management, content editing, access control, and AI-powered transformations via MCP.1MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that provides native access to Quip documents from any MCP-compatible AI client (Claude Desktop, Claude Code, or custom integrations). Search, browse, and read Quip documents as clean markdown.5-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to access and manage Google Workspace services such as Gmail, Drive, Docs, Sheets, Calendar, and Slides through the MCP protocol, with built-in OAuth 2.0 authentication and read/write tool support.-