Quip MCP Server (TypeScript)

by zxkane

1 stars
317 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server for fetching Quip documents, featuring support for both stdio and streamable HTTP transports. It offers native deployment to AWS serverless stacks and AgentCore.

Details

Author
zxkane
GitHub stars
1
Downloads
317
Categories
Cloud Service

- Retrieve Quip spreadsheet content as CSV with metadata
- Support for selecting specific sheets by name
- Automatic truncation of large spreadsheets
- Mock mode for testing without a real Quip API token
- Multiple storage options: local filesystem and Amazon S3
- API key authentication and health check endpoint

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Quip MCP Server (TypeScript)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally via npm (npm install -g @zxkane/quip-mcp-server) or from source. Set the QUIP_TOKEN environment variable with your Quip API token. Run the server with default stdio transport using npm start, or use command‑line arguments to configure storage paths, debug mode, mock mode, authentication, and HTTP/SSE options. For Claude.app, add a JSON configuration block to your MCP settings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "quip mcp server (typescript)": {
            "quip-mcp-server-typescript": {
                "command": "node",
                "args": [
                    "dist/index.js",
                    "--storage-path",
                    "/path/to/storage"
                ]
            }
        }
    }
}

McpServers

{
    "quip-mcp-server-typescript": {
        "command": "node",
        "args": [
            "dist/index.js",
            "--storage-path",
            "/path/to/storage"
        ]
    }
}

Quip MCP Server (TypeScript)

A Model Context Protocol (MCP) server for interacting with Quip spreadsheets, implemented in TypeScript. This server provides tools to read spreadsheet data from Quip documents and return the content in CSV format.

🚀 AWS Pay-as-You-Go Serverless Deployment

Deploy to AWS with zero infrastructure management and pay only for what you use!

⚡ AWS Agent Core Runtime (Recommended)

- 🔧 SSE Support: Built-in Server-Sent Events for real-time streaming - ⏱️ Extended Runtime: Up to 8 hours execution time - 📦 Large Payloads: 100MB payload support - 🔐 Built-in Auth: Integrated OAuth and identity management - 💰 Consumption-based: Pay only for actual runtime usage
cd infrastructure/agent-core
./deploy.sh --agent-name my-quip-mcp --secret-arn arn:aws:secretsmanager:...

🌐 AWS Lambda + API Gateway

- 📈 Auto-scaling: Handles varying loads automatically - 🌍 Global: Distributed across multiple availability zones - 💸 Cost-effective: Pay per request with generous free tier - 🔌 HTTP Interface: Works with any HTTP MCP client
cd infrastructure/api-gateway-lambda
./deploy.sh --secret-arn arn:aws:secretsmanager:...

Both options provide enterprise-grade serverless infrastructure with no servers to manage!

Table of Contents

- Features
- Installation
- Using npm
- From Source
- Environment Variables
- Usage
- Running the Server
- Transport Documentation
- Configure for Claude.app
- Command Line Arguments
- Server-Sent Events (SSE) Support
- Deploy to AWS Lambda + API Gateway
- Available Tools
- quip_read_spreadsheet
- Resource URIs
- How It Works
- Error Handling
- Mock Mode
- Structured Logging
- Authentication
- Caching
- Storage Options
- Local Storage
- S3 Storage
- Health Check Endpoint
- Cloud Deployment
- AWS Lambda + API Gateway
- AWS Agent Core Runtime
- Development
- Project Structure
- Setting Up a Development Environment
- Scripts
- Running Tests
- Debugging
- Adding New Tools
- Contributing
- License

Features

- 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 when necessary
- Stores spreadsheet content locally for efficient access
- Multiple storage options including local filesystem and Amazon S3
- Provides resource URIs for accessing complete spreadsheet content
- Enhanced error handling with detailed error messages and proper error types
- Mock mode for testing without a real Quip API token
- Structured logging with different log levels (debug, info, warn, error)
- API key authentication for securing the HTTP server
- Caching mechanism for improved performance with frequently accessed resources
- Health check endpoint for monitoring server status

Installation

Using npm

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.