send-to-kindle

Email PDF, EPUB, DOC, and TXT documents to Kindle via Gmail OAuth2.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/josh-cooper/.claude --skill send-to-kindle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: send-to-kindle
Source: https://github.com/josh-cooper/.claude/tree/main/skills/send-to-kindle
Command: npx skills add https://github.com/josh-cooper/.claude --skill send-to-kindle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth-httplib2, google-auth-oauthlib, and includes scripts (resource) components.

What problem does it solve?

This skill automates sending documents to a Kindle device via Gmail, turning a multi-step manual process into a single action.

Core Features & Use Cases

  • Attach common formats (PDF, DOC, EPUB, TXT, images) to an email sent to the Kindle email address.
  • Uses OAuth credentials and per-user configuration to securely transfer files.
  • Use Case: You want to read a document on Kindle during travel; simply send it via the skill.

Quick Start

Configure KINDLE_EMAIL and credentials, install dependencies, and run the send_to_kindle script with your file.

Frequently Asked Questions about send-to-kindle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically send documents to Kindle via Gmail?

You can automatically send documents to Kindle by configuring a script that uses Gmail OAuth2 authentication to email files directly to your Kindle email address. This skill automates the transfer process, requiring only your KINDLE_EMAIL and valid Google API credentials to function.

What document formats can I transfer to my Kindle using Gmail automation?

Gmail automation supports sending common document formats including PDF, DOC, EPUB, TXT, and images. The script attaches these files to an email sent to your Kindle address, allowing you to wirelessly transfer them to your device for reading on the go.

Do I need OAuth2 credentials to email files to my Kindle?

Yes, OAuth2 credentials are required to securely authenticate with the Gmail API and send documents to your Kindle. You must configure Gmail API scopes and store your credentials in the designated directory to ensure reliable and secure file transfers.

Can I use this script to send documents to Kindle while traveling?

Yes, this script is designed for scenarios like travel where you want to read documents on your Kindle. By running the send_to_kindle script with your file, it handles the email delivery automatically, making it easy to wirelessly transfer files to your device from anywhere.

What Gmail API dependencies are required to automate Kindle document delivery?

Automating Kindle document delivery requires installing google-api-python-client, google-auth-httplib2, and google-auth-oauthlib. These dependencies enable the OAuth2 authentication and Gmail API interactions needed to attach files and send emails to your Kindle address.

Why does sending a PDF to Kindle via Gmail fail?

Sending a PDF to Kindle via Gmail fails if OAuth credentials are invalid, Gmail API scopes are missing, or the KINDLE_EMAIL is not configured. Ensure credentials are stored in the skill's credentials directory and that your Kindle account is approved to receive files from your Gmail address.