Content
# Hermes Maton MCP — Google Workspace Integration
> ****
MCP server for Maton.ai integration — unified API access to Google Sheets, Calendar, Gmail, and Drive through a single API key.
---
## Security & Best Practices
⚠️ **Important:**
- Your API key provides **full access** to the linked Google account.
- Store the key in `~/.hermes/.env` (never commit it to Git).
- Rotate the key immediately if compromised.
- Use a separate Maton project for each environment (development/production).
---
## Supported Services
### MCP Server (24 services, 150+ actions)
The Maton MCP server (`@maton/mcp`) provides access to **24 applications** with **150+ actions** total via the Model Context Protocol.
#### Full Action List
| Service | Key Actions | Notes |
|---------|-------------|-------|
| **Google Calendar** | create-event, list-events, update-event, delete-event, get-calendar | Full calendar management |
| **Google Sheets** | add-column, update-cell, get-values-in-range, create-spreadsheet, update-multiple-rows | Complete spreadsheet CRUD |
| **Gmail** | send-email, create-draft, find-email, list-labels, add-label-to-email | Send, search, label management |
| **Google Drive** | create-file, create-folder, list-files, find-file, upload/download | File & folder operations |
| **Google Docs** | create-document, append-text, find-document, get-document | Read/write documents |
| **HubSpot** | create-contact, list-contacts, update-contact, create-deal, merge-contacts | CRM (contacts & deals) |
| **Salesforce** | create-contact, get-contact, list-contacts | Basic CRM (limited) |
| **Pipedrive** | search-people | People search |
| **Asana** | create-task, list-tasks, list-projects, list-workspaces | Project & task management |
| **ClickUp** | create-task, list-tasks, list-folders, list-spaces, list-lists | Hierarchical tasks |
| **Jira** | get-issue, list-issues, add-comment-to-issue, list-projects, list-users | Issue tracking |
| **Slack** | list-channels, list-messages, send-message, list-replies | Team communication |
| **Outlook** | create-draft, find-email, send-email | Email (Microsoft 365) |
| **Calendly** | list-event-types, list-events, get-event, list-event-invitees | Scheduling & appointments |
| **Airtable** | list-bases, list-records, list-tables | No-code database |
| **Notion** | create-page, find-page, get-page | Knowledge base |
| **JotForm** | list-forms, list-submissions | Form submissions |
| **Mailchimp** | get-campaign, search-campaign | Email marketing (limited) |
| **Klaviyo** | create-campaign, create-list, create-profile, send-campaign, get-profiles | E-commerce marketing |
| **Shopify** | create-order, get-order, list-orders | E-commerce orders |
| **Stripe** | create-customer, create-invoice, list-customers, list-invoices | Payments & invoicing |
| **Typeform** | get-form, list-forms, list-responses | Forms & surveys |
| **YouTube** | list-videos, search-videos | Video content |
| **AWS** | get-s3-object, list-s3-buckets, list-s3-objects | S3 only |
**Complete action reference:** [maton-ai/agent-toolkit#available-api-actions](https://github.com/maton-ai/agent-toolkit#available-api-actions)
> **Note:** This MCP server (`hermes-maton-mcp`) configures the official `@maton/mcp` package. The tool names in Hermes will be prefixed with `mcp_maton_` (e.g., `mcp_maton_google_sheet_update_cell`). See `Usage Examples` below for Google Workspace; other services follow similar patterns.
---
### Full Maton API (150+ services)
Beyond MCP, Maton's REST API integrates **150+ SaaS applications** across all major categories. The MCP server above covers the most common 24 apps. For the full catalog:
- **CRM & Sales:** HubSpot (full), Salesforce (full), Pipedrive, Zoho CRM, Freshsales, Close.io, Copper, Insightly, Monday.com, and 30+ more.
- **Project Management:** Asana (full), ClickUp (full), Jira (full), Trello, Basecamp, Wrike, Teamwork, Monday.com, and 20+ more.
- **Communication:** Slack (full), Outlook (full), Gmail (full), Microsoft Teams, Telegram, Discord, Intercom, Zendesk, Freshdesk, Help Scout, and 25+ more.
- **E-commerce & Payments:** Shopify (full), Stripe (full), WooCommerce, BigCommerce, Square, PayPal, QuickBooks, Xero, and 15+ more.
- **Marketing & Automation:** Mailchimp (full), Klaviyo (full), Typeform (full), HubSpot Marketing, ActiveCampaign, ConvertKit, MailerLite, SendGrid, and 20+ more.
- **Productivity:** Airtable (full), Notion (full), Google Workspace (full), Microsoft 365, Dropbox, Box, Confluence, Evernote, and 15+ more.
- **DevOps & Cloud:** AWS (S3 only via MCP), Google Cloud, Azure, DigitalOcean, Vercel, Netlify, GitHub, GitLab, and 10+ more.
- **Analytics & BI:** Google Analytics, Mixpanel, Amplitude, Segment, Metabase, Looker, Tableau, and 10+ more.
**Access to full catalog:** Requires Maton subscription (Pro/Enterprise). Log into [Maton Dashboard](https://maton.ai) → Integrations to browse all 150+ apps. Each integration has its own API key scoped to that service.
**Why MCP only 24?** MCP is a new protocol. Maton prioritizes most-requested apps for MCP first. The full REST API covers everything else.
## What
Single-point integration with Google Workspace via Maton.ai. No OAuth dance, no service accounts — just one API key and you're in.
**Capabilities:**
- Google Sheets: read/write, create sheets, format cells
- Google Calendar: events, reminders, scheduling
- Gmail: send/receive, search, labels
- Google Drive: upload/download, folder management
---
## Why Maton?
Standard Google APIs require:
- OAuth 2.0 flow (user consent screens)
- Service account setup (JSON keys)
- Token refresh logic
- Scopes management
Maton wraps all this into a simple REST API with one key. Perfect for AI agents that need Google Workspace access without human-in-the-loop OAuth.
---
## Quick Start
1. Get Maton API key from [maton.ai](https://maton.ai)
2. Add to `~/.hermes/config.yaml`:
```yaml
mcp_servers:
maton:
command: npx
args:
- -y
- hermes-maton-mcp@latest
- --apiKey=maton_live_xxxxx
```
3. `hermes gateway restart`
4. `hermes tools | grep maton` — should show tools
## Setup
### 1. Get Maton API Key
1. Sign up at [maton.ai](https://maton.ai)
2. Create new project → "Google Workspace Integration"
3. Copy API key (starts with `maton_`)
### 2. Add to Hermes Config
```yaml
mcp_servers:
maton:
command: npx
args:
- -y
- hermes-maton-mcp@latest
- --apiKey=maton_live_xxxxxxxxxxxx
```
### 3. Restart Gateway
```bash
hermes gateway restart
```
### 4. Verify
```bash
hermes tools | grep maton
# Should show: mcp_maton_google_sheet, mcp_maton_calendar, etc.
```
---
## Usage Examples
### Write to Google Sheet
```bash
hermes call mcp_maton_google_sheet_update_cell \
--spreadsheet_id="1AbcDEFgHiJkLmNoPqRsTuVwXyZ" \
--worksheet_id=0 \
--cell="A1" \
--value="Hello from Hermes Agent"
```
### Create Calendar Event
```bash
hermes call mcp_maton_calendar_create_event \
--calendar_id="primary" \
--summary="Team Sync" \
--start="2026-05-10T10:00:00Z" \
--end="2026-05-10T11:00:00Z" \
--attendees="user@example.com,dev@company.com"
```
### Send Email
```bash
hermes call mcp_maton_gmail_send_message \
--to="client@example.com" \
--subject="Project Update" \
--body="Dear client, ..."
```
### Upload File to Drive
```bash
hermes call mcp_maton_google_drive_upload_file \
--file_path="/path/to/report.pdf" \
--folder_id="1FolderIdHere"
```
---
## Python Agent Example
```python
from hermes import Agent
agent = Agent()
# Log sales data to Google Sheet
agent.run("""
1. Read sales CSV from /data/yesterday.csv
2. For each row, append to Google Sheet 'Sales Log'
spreadsheet_id: 1AbcDEF...
worksheet_id: 0
""")
# Schedule daily standup
agent.run("""
Create calendar event:
summary: Daily Standup
start: tomorrow 10:00
end: tomorrow 10:30
attendees: team@company.com
""")
```
---
## Security Notes
⚠️ **Important:**
- API key grants full access to linked Google account
- Store key in `~/.hermes/.env` (never commit)
- Rotate key if compromised
- Use separate Maton project for each environment (dev/prod)
---
## Security Notes
⚠️ **Important:**
- API key grants full access to linked Google account
- Store key in `~/.hermes/.env` (never commit to Git)
- Rotate key if compromised
- Use separate Maton project for each environment (dev/prod)
## Troubleshooting
### "Invalid API key"
- Check key is correct in `config.yaml`
- Verify Maton account is active
- Ensure Google Workspace integration enabled in Maton dashboard
### "Permission denied" on Google Sheets
- Check spreadsheet sharing settings (should be accessible by service account)
- Verify `spreadsheet_id` is correct
- Ensure worksheet exists (`worksheet_id=0` is first sheet)
### Rate limits
Maton enforces per-project rate limits:
- Free tier: 1000 requests/day
- Pro: 100,000 requests/day
- Enterprise: unlimited
See Maton dashboard for usage stats.
---
## Advanced: Batch Operations
```python
# Update multiple cells at once
agent.run("""
Update range A1:C10 in spreadsheet 1AbcDEF...
with values:
[["Name", "Email", "Status"],
["Alice", "alice@example.com", "Active"],
["Bob", "bob@example.com", "Pending"]]
""")
```
---
## Limitations
- No Google Docs editing (only Sheets, Calendar, Mail, Drive)
- No real-time push notifications (polling only)
- Maton downtime → all Google operations fail (consider fallback)
---
## Roadmap
- [ ] Google Docs support (read/write)
- [ ] Batch operations optimization
- [ ] Webhook notifications for calendar events
- [ ] Built-in retry logic for failed requests
- [ ] Local cache for offline operations
---
## Links
- **Repo:** https://github.com/Maatq1544/hermes-maton-mcp
- **Maton.ai:** https://maton.ai
- **Issues:** https://github.com/Maatq1544/hermes-maton-mcp/issues
---
*Made by · 2026 · MIT License*
## License
MIT — see [LICENSE](LICENSE)
## Author
Agent Hermes — Lisa Carter
[GitHub @Maatq1544](https://github.com/Maatq1544)
