Frequently Asked Questions¶

ExtraSuite lets AI assistants like Claude Code and Codex work with your Google Sheets, Docs, and Slides. Instead of copy-pasting data, you can ask your AI to read, analyze, and edit your documents directly.

Three simple steps:

1. Install the skill - Run the install command from the homepage in your terminal
2. Share your document - Share your Google Sheet with your service account email
3. Ask your AI - Ask Claude Code or Codex to read or modify your document

See the Getting Started Guide for detailed instructions.

ExtraSuite currently supports:

• Claude Code - Anthropic's coding assistant
• Codex CLI - OpenAI's coding assistant
• Gemini CLI - Google's coding assistant
• Claude Coworks - Anthropic's collaborative workspace
• Cursor - AI-powered code editor

See Installation Guides for platform-specific instructions.

Yes, a one-time setup. Run the install command from the homepage in your terminal. This adds the Google Sheets skill to your AI assistant. The installation takes a few seconds.

No. The AI can only access documents you explicitly share with your service account email. If you don't share a document, the AI cannot see it. This uses standard Google Drive sharing - you're in complete control.

Learn more in our Security documentation.

Yes, instantly. Just remove your service account from the document's sharing settings in Google Drive, the same way you'd remove any other collaborator. Access is revoked immediately.

See Revoking Access for detailed instructions.

All changes appear in Google's version history under your agent's name. You can review exactly what changed and use Google's built-in "See version history" feature to undo any changes. Nothing is permanent.

Access tokens expire after 1 hour. After that, the skill will automatically prompt you to re-authenticate if needed. No long-lived credentials are stored or distributed.

ExtraSuite stores minimal data:

• Your email address (for authentication)
• The mapping between your email and service account

ExtraSuite does not store:

• Your document contents
• Access tokens (generated on-demand)
• Any data from your Google Workspace

Here are some examples:

• Generate reports from your data and write them to a Sheet
• Clean up and format messy spreadsheet data
• Create charts and summaries from raw numbers
• Extract data from one sheet and transform it into another format
• Automate repetitive spreadsheet tasks through natural language

See Prompting Guide for more examples.

It's a special email address that represents your AI assistant. Think of it like a dedicated robot helper that only works for you. When you share a document with this email, you're granting access specifically to your AI assistant.

Find your service account email on the ExtraSuite homepage after signing in.

Google Sheets is fully supported today. Google Docs and Slides support is in alpha - the infrastructure is ready, we're just finalizing the skills.

See Skills Overview for current status.

1. Open your Google Sheet
2. Click Share (top right)
3. Paste your service account email
4. Choose permission level (Viewer, Commenter, or Editor)
5. Click Send

See Sharing Documents for detailed instructions.

Yes, if your organization has enabled domain-wide delegation. This is an optional feature that allows agents to access user-level APIs like Gmail, Calendar, and Apps Script.

Your admin must:

1. Set DELEGATION_ENABLED=true on the ExtraSuite server (optionally set DELEGATION_SCOPES to restrict which scopes can be requested)
2. Set up domain-wide delegation in Google Workspace Admin Console

Once configured, use extrasuite authorize --scopes gmail.send --reason "sending report" to get a delegated token.

No. Domain-wide delegation is entirely optional and only needed for user-level API access (Gmail, Calendar, Apps Script). The core ExtraSuite functionality (Sheets, Docs, Slides) works without it using the standard service-account-per-user model.

• macOS - Full support
• Linux - Full support
• Windows - Supported via PowerShell or WSL

See Installation Guides for platform-specific instructions.

Python 3.8 or higher is required. The skill creates its own virtual environment, so it won't interfere with your system Python.

Skills are installed to platform-specific directories:

Re-run the install command from the ExtraSuite homepage. This downloads the latest version of all skills.

Remove the skill directory:

rm -rf ~/.claude/skills/gsheets  # For Claude Code
rm -rf ~/.codex/skills/gsheets   # For Codex CLI
# etc.

1. Make sure you're using the correct command for your OS
2. The token in the URL expires after 5 minutes - refresh the page for a new one
3. Check that your terminal has internet access

1. Verify the URL is correct
2. Check that you've shared the document with your service account email
3. Make sure you copied the full service account email (including the domain)

1. Check the permission level (Viewer won't allow writes)
2. Verify the document is shared with the correct service account
3. Try removing and re-adding sharing

1. Clear your browser cookies for extrasuite.think41.com
2. Re-authenticate through the ExtraSuite homepage
3. Clear cached tokens:

   rm -f ~/.config/extrasuite/token.json
   

1. Verify the skill is installed:

   ls ~/.claude/skills/gsheets/SKILL.md
   

2. Try explicitly mentioning the skill:

   Using the gsheets skill, read the data from...
   

• Documentation issues: Check this FAQ and our User Guide
• Technical problems: Contact your IT administrator
• Bug reports: Use internal support channels
• Feature requests: Contact the platform team

Check the Skills Overview for current status and planned features for each skill.