n8n-nodes-google-custom

This is an n8n community node package for Google services with Bearer Token and auto-refreshing token authentication.

⚡ Key Features:

• 🔐 Bearer Token authentication (no OAuth flow needed)
• 🔄 Auto-refreshing tokens (Refresh Token support)
• 📅 Customized Google Services: Calendar, Sheets, Gmail, Drive, Docs, Contacts, Tasks
• 🚀 Easy to set up and use

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter n8n-nodes-google-custom in Enter npm package name.
4. Agree to the risks of using community nodes.
5. Select Install.

Manual Installation

To install manually for local development or testing:

# Navigate to your n8n installation
cd ~/.n8n/custom

# Install the package
npm install n8n-nodes-google-custom

# Link for development
npm link n8n-nodes-google-custom

Quick Test

Bearer Token Test

node test/test-bearer-token.js YOUR_BEARER_TOKEN

Refresh Token Test (Recommended)

node test/test-refresh-token.js CLIENT_ID CLIENT_SECRET REFRESH_TOKEN

Credentials

These nodes support two authentication methods:

1. Bearer Token (Manual)

1. Go to the Google Cloud Console
2. Create or select a project
3. Enable the required Google APIs (Calendar, Sheets, Gmail, Drive, Docs, Contacts, Tasks)
4. Create credentials (Service Account or OAuth 2.0)
5. Generate an access token
6. In n8n, create new "Google API (Bearer Token)" credentials
7. Paste your Bearer Token

2. Refresh Token (Auto-Refresh) - Recommended

1. Set up OAuth 2.0 credentials in Google Cloud Console
2. Obtain Client ID, Client Secret, and Refresh Token
3. In n8n, create new "Google API (Refresh Token)" credentials
4. Enter your credentials
5. Token will auto-refresh when expired (handled by GoogleAuthHelper)

See REFRESH_TOKEN_GUIDE.md for detailed instructions.

Available Customized Nodes

All nodes support both Bearer Token and Refresh Token authentication, and are compatible with AI

1. Google Calendar Custom 📅

• Resources: Calendar, Event
• Operations: Create, Get, Get Many, Update, Delete events
• Special: Check availability, recurring events support
• AI Agent ready: Yes

2. Google Sheets Custom 📊

• Resources: Sheet, Spreadsheet
• Operations:
  • Sheet: Read, Append, Update, Clear, Delete rows
  • Spreadsheet: Create, Delete
• AI Agent ready: Yes

3. Gmail Custom 📧

• Resources: Message, Label, Draft
• Operations:
  • Message: Send, Reply, Get, Get Many, Delete
  • Label: Create, Get Many, Delete
  • Draft: Create, Get, Get Many, Delete
• AI Agent ready: Yes

4. Google Drive Custom 💾

• Resources: File, Folder
• Operations:
  • File: List, Upload, Download, Delete, Share, Copy
  • Folder: Create, Delete, Share
• AI Agent ready: Yes

5. Google Docs Custom 📝

• Resources: Document
• Operations: Create, Get, Append Text, Replace Text
• AI Agent ready: Yes

6. Google Contacts Custom 👥

• Resources: Contact
• Operations: Create, Get, Get Many, Update, Delete
• AI Agent ready: Yes

7. Google Tasks Custom ✅

• Resources: Task, Task List
• Operations:
  • Task: Create, Get, Get Many, Update, Delete
  • Task List: Create, Get Many, Delete
• AI Agent ready: Yes

Compatibility

Tested with n8n version 1.0.0+

Resources

• n8n community nodes documentation
• Google Calendar API documentation

License

MIT