Quip MCP Server
@zxkane
Model Context Procotol(MCP) server for fetching Quip document
概览
What is Quip MCP Server?
A Model Context Protocol (MCP) server for interacting with Quip spreadsheets. It provides tools to read spreadsheet data from Quip documents and return the content in CSV format. Designed for developers building AI-powered tools that need to query spreadsheet data stored in Quip.
How to use Quip MCP Server?
Install via uvx (recommended) or pip, then set environment variables QUIP_TOKEN and optionally QUIP_BASE_URL and QUIP_STORAGE_PATH. Run the server with uvx quip-mcp-server or python -m src.server. Use the quip_read_spreadsheet tool with a threadId and optional sheetName.
Key features of Quip MCP Server
- Retrieve spreadsheet content from Quip documents.
- Support for selecting specific sheets by name.
- Returns data in CSV format with metadata.
- Handles authentication via Quip API token.
- Provides appropriate error messages for non-spreadsheet documents.
- Automatically handles large spreadsheets by truncating content.
Use cases of Quip MCP Server
- Extracting data from a Quip spreadsheet for analysis in an AI agent.
- Integrating Quip spreadsheets into a conversational AI assistant.
- Automating data retrieval from Quip documents for reporting.
FAQ from Quip MCP Server
What does the server do vs alternatives?
It provides MCP tools to read Quip spreadsheet data and return it as CSV, using the Quip API to export to XLSX then convert, with a fallback to HTML parsing.
What are the runtime requirements?
Python 3.12, a Quip API token, and the Quip platform base URL (optional). It uses uv for dependency management and can run via uvx or pip.
Where does spreadsheet data live?
Data is stored locally in CSV files at the configured --storage-path (default: ~/.quip-mcp-server/storage). Resource URIs reference these files using quip:// or file:// protocols.
What are the known limits?
Large spreadsheets are truncated to 10KB in the tool response, but complete content is accessible via resource URIs. Non-spreadsheet documents return an error.
What transports/auth are supported?
Stdio transport (and optionally HTTP in the TypeScript version). Authentication uses a Quip API token set via QUIP_TOKEN environment variable.
