Quip MCP Server

A Model Context Protocol (MCP) server for reading Quip documents and spreadsheets. Works with Claude Desktop and any MCP-compatible client.

Quick Setup

Run the setup script — it will prompt for your Quip token and configure Claude Desktop automatically:

bash <(curl -fsSL https://raw.githubusercontent.com/yashjain/quip-mcp/main/setup.sh)

Or manually add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "quip": {
      "command": "npx",
      "args": [
        "-y",
        "@yashj645/quip-mcp-server",
        "--storage-path",
        "/Users/yourname/.quip-mcp/storage",
        "--file-protocol"
      ],
      "env": {
        "QUIP_TOKEN": "your_quip_api_token"
      }
    }
  }
}

Get your Quip API token from: https://your-quip-domain.quip.com/dev/token

Installation

# Run directly with npx (no install needed)
npx @yashj645/quip-mcp-server

# Or install globally
npm install -g @yashj645/quip-mcp-server

Requires Node.js v18+.

Available Tools

quip_read_document

Reads the text content of a regular Quip document (not a spreadsheet).

Parameters:

• threadId (required): The Quip thread ID (part of the URL after your Quip domain)

Example:

{ "threadId": "AbCdEfGhIjKl" }

Response:

{
  "thread_id": "AbCdEfGhIjKl",
  "title": "My Document",
  "type": "document",
  "text_content": "Full plain text content of the document...",
  "word_count": 342
}

---

quip_read_spreadsheet

Reads a Quip spreadsheet and returns its content as CSV.

Parameters:

• threadId (required): The Quip thread ID
• sheetName (optional): Name of the sheet to read. Defaults to the first sheet.

Example:

{ "threadId": "AbCdEfGhIjKl", "sheetName": "Sheet1" }

Response:

{
  "csv_content": "header1,header2\nvalue1,value2\n...",
  "metadata": {
    "total_rows": 1000,
    "total_size": 52840,
    "is_truncated": true,
    "resource_uri": "file:///Users/yourname/.quip-mcp/storage/AbCdEfGhIjKl-Sheet1.csv"
  }
}

Content is truncated at 10KB in the response. The full CSV is saved locally and accessible via resource_uri.

---

Finding the Thread ID: It's the segment in the Quip URL right after your domain.
Example: https://yourcompany.quip.com/S6eaArZiT0xy/Doc-Title → thread ID is S6eaArZiT0xy

Usage with Claude

Once set up, ask Claude:

• "Read the Quip document with thread ID S6eaArZiT0xy"
• "Read the Quip spreadsheet with thread ID AbCdEfGhIjKl"
• "Read the sheet named 'Q1 Data' from the Quip spreadsheet AbCdEfGhIjKl"

Command Line Arguments

Argument	Description	Default
--storage-path <path>	Where to store CSV files locally	~/.quip-mcp-server/storage
--file-protocol	Use file:// URIs for resource access	off
--port <port>	Run as HTTP server on this port	stdio mode
--mock	Use mock data (no Quip token needed)	off
--debug	Enable debug logging	off
--storage-type <type>	local or s3	local
--s3-bucket <name>	S3 bucket (when using S3 storage)	—
--s3-region <region>	S3 region	—

Environment Variables

QUIP_TOKEN=your_token           # Required (unless --mock)
QUIP_BASE_URL=https://platform.quip.com  # Optional
QUIP_STORAGE_PATH=/path/to/storage       # Optional
STORAGE_TYPE=local              # 'local' or 's3'

HTTP Mode (for team sharing)

Run as a shared HTTP server so others on your team can connect without installing anything locally:

QUIP_TOKEN=your_token npx @yashj645/quip-mcp-server --port 3000

Others then configure:

{
  "mcpServers": {
    "quip": {
      "url": "http://your-server:3000/mcp"
    }
  }
}

Development

git clone https://github.com/yashj645/quip-mcp-server.git
cd quip-mcp-server
npm install
npm run build
npm test

Mock mode (no Quip token needed):

node dist/index.js --mock --storage-path ./storage

License

MIT