Skip to content

This tool facilitates seamless export of documents from Quip to both local filesystem and Notion

License

Notifications You must be signed in to change notification settings

topmonks/quip-export

Repository files navigation

Quip to Notion Export Tool

Description

This tool simplifies the process of exporting documents from Quip to both the local filesystem and Notion. Whether you're migrating your documents or need to maintain backups, this tool provides a straightforward solution.

Features

  • Export to Local Filesystem: Save Quip documents directly to your local machine.
  • Export to Notion: Seamlessly transfer Quip documents to your Notion workspace.
  • Optional Image Upload to AWS S3: Effortlessly include images from Quip documents by uploading them to AWS S3.
  • Rate Limit Handling: Intelligent handling of Quip rate limits by saving temporary export state to file, enabling easy resume later.
  • Preserve Formatting: Retain document formatting and structure during the export process.
  • Command-line Interface: Easy-to-use CLI for smooth execution.

Prerequsities

Before using Quip Exporter, ensure you have the following prerequisites in place:

  1. Obtain Quip Developer Token:

    • Visit https://<your-organization>.quip.com/dev/token and generate a developer token for your Quip organization. This token will be used to authenticate the exporter tool with Quip's API.
  2. Create Notion Internal Integration:

    • Navigate to Notion Integrations and create an internal integration to obtain a Notion token. This token is required for authentication with Notion's API.
  3. Set Up Notion Workspace:

    • Create a Notion workspace if you haven't already.
    • Create an empty document within your Notion workspace. This document will serve as the root for importing Quip documents.
    • Grant access to your Notion integration by following the instructions provided here.

Usage

npx @topmonks/quip-notion

Example run with all options

npx @topmonks/quip-notion -q "QUIP_TOKEN" -n "NOTION_API_KEY" -root "NOTION_ROOT_PAGE" -s3 --aws-access-key "AWS_ACCESS_KEY_ID" --aws-secret-access-key "AWS_SECRET_ACCESS_KEY" --aws-region "AWS_REGION" --aws-bucket "AWS_BUCKET" -a fs notion

Usage: quip-notion [options]

Options:
  -V, --version                                         output the version number
  -q, --quip-api-token <quip-api-token>                 quip api token received from https://[your-organization].quip.com/dev/token
  -n, --notion-token [notion-token]                     notion api token received from https://www.notion.so/my-integrations
  -root, --notion-root-document [notion-root-document]  id of the root page in Notion where you want to import the documents
  -a, --adapters [adapters...]                          specify adapters (fs, notion) (default: ["fs","notion"])
  -s3                                                   upload images from quip to s3 and link them (default: false)
  --aws-access-key [aws-access-key]                     aws access key to access s3
  --aws-secret-access-key [aws-secret-access-key]       aws secret access key to access s3
  --aws-region [aws-region]                             aws region used for the s3
  --aws-bucket [aws-bucket]                             s3 bucket name
  -h, --help                                            display help for command

About

This tool facilitates seamless export of documents from Quip to both local filesystem and Notion

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published