send-to-kindle

josh-cooper's avatarfrom josh-cooper

Send documents to Kindle via email. Use when user wants to send files to Kindle, read documents on Kindle, transfer ebooks, or send PDFs/EPUBs to their e-reader.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026
[Files and Documents]

When & Why to Use This Skill

The Send to Kindle skill streamlines the process of transferring digital documents to your e-reader via the Gmail API. It supports a wide array of formats including EPUB, PDF, and DOCX, allowing users to seamlessly move content from their computer to their Kindle for a more comfortable, focused reading experience.

Use Cases

  • Transferring long-form web articles or research papers to Kindle for distraction-free, eye-friendly reading.
  • Sending personal ebooks (EPUB/MOBI) and manuscripts to an e-reader without the need for physical USB cables.
  • Reviewing professional reports, PDF documents, or scripts on the go using an e-ink display.
  • Converting digital documentation and text files into a portable format for offline reading during commutes or travel.
namesend-to-kindle
descriptionSend documents to Kindle via email. Use when user wants to send files to Kindle, read documents on Kindle, transfer ebooks, or send PDFs/EPUBs to their e-reader.

Send to Kindle

Send documents to a Kindle device via Gmail API.

Supported Formats

PDF, DOC, DOCX, TXT, RTF, HTM, HTML, PNG, GIF, JPG, JPEG, BMP, EPUB

Pre-flight Checks

Before sending, verify setup is complete. Run these checks:

# Check all prerequisites at once
cd ~/.claude/skills/send-to-kindle && \
[ -d venv ] && source venv/bin/activate && python -c "import googleapiclient; import google_auth_oauthlib" 2>/dev/null && echo "Dependencies: OK" || echo "Dependencies: MISSING (run venv setup)" && \
[ -n "$KINDLE_EMAIL" ] && echo "KINDLE_EMAIL: $KINDLE_EMAIL" || echo "KINDLE_EMAIL: MISSING" && \
[ -f credentials/credentials.json ] && echo "OAuth credentials: OK" || echo "OAuth credentials: MISSING" && \
[ -f credentials/token.json ] && echo "Auth token: OK" || echo "Auth token: MISSING (run auth.py)"

If Setup Incomplete

If any check shows MISSING, help the user complete setup:

Dependencies missing

cd ~/.claude/skills/send-to-kindle && python3 -m venv venv && source venv/bin/activate && pip install -r scripts/requirements.txt

KINDLE_EMAIL missing

Ask the user for their Kindle email address, then instruct them to set it:

export KINDLE_EMAIL="<their-email>@kindle.com"

Remind them to add this to their shell profile (~/.zshrc or ~/.bashrc) for persistence.

Find Kindle email at: Amazon > Manage Your Content and Devices > Preferences > Personal Document Settings

OAuth credentials missing

Guide them through Google Cloud Console setup:

  1. Go to https://console.cloud.google.com/
  2. Create project and enable Gmail API
  3. Create OAuth 2.0 Client ID (Desktop app)
  4. Download JSON and save as ~/.claude/skills/send-to-kindle/credentials/credentials.json

See README.md in the skill directory for detailed steps.

First-time authentication

Once credentials.json exists:

cd ~/.claude/skills/send-to-kindle && source venv/bin/activate && python scripts/auth.py

This opens a browser for Google sign-in.

Approved sender

User's Gmail must be added to Kindle's approved senders list in Amazon account settings.

Sending a Document

Once setup is verified:

cd ~/.claude/skills/send-to-kindle && source venv/bin/activate && python scripts/send_to_kindle.py "<file_path>"

Note: If the file path contains special characters (;, ©, commas, etc.), copy the file to a simpler filename first to avoid shell escaping issues.

Report success or failure to user.

Troubleshooting

  • Auth error / "Insufficient Permission": Delete ~/.claude/skills/send-to-kindle/credentials/token.json and re-run auth.py to re-authenticate with correct scopes
  • Not delivered: Gmail must be in Kindle's approved senders list
  • File too large: Must be under 25MB
  • File not found with special characters: Copy file to a simpler filename without ;, ©, or other special characters