---

name: gmail description: Fast Gmail access via FGP daemon (10x faster than MCP) tools:

• gmail.inbox
• gmail.unread
• gmail.search
• gmail.send
• gmail.thread

---

Gmail Skill

Fast Gmail integration via the FGP daemon. Provides 10x faster response times than MCP-based tools.

Available Methods

Method Parameters

gmail.inbox

Copyfgp call gmail.inbox -p '{"limit": 10}'

gmail.unread

No parameters. Returns unread count and first 10 unread email summaries.

Copyfgp call gmail.unread

gmail.search

Copyfgp call gmail.search -p '{"query": "from:newsletter", "limit": 5}'

Search syntax examples:

• from:sender@example.com - Filter by sender
• to:recipient@example.com - Filter by recipient
• subject:keyword - Filter by subject
• is:unread - Only unread emails
• after:2025/01/01 - After date
• before:2025/12/31 - Before date
• has:attachment - Has attachments
• label:important - Has label

gmail.send

Copyfgp call gmail.send -p '{"to": "user@example.com", "subject": "Hello", "body": "Message body"}'

gmail.thread

Copyfgp call gmail.thread -p '{"thread_id": "18abc123"}'

Response Schemas

Email Object

Copy{
  "id": "18abc123",
  "thread_id": "18abc123",
  "from": "sender@example.com",
  "subject": "Meeting tomorrow",
  "date": "Mon, 13 Jan 2026 10:00:00 -0800",
  "snippet": "Just a reminder about our meeting..."
}

inbox/search Response

Copy{
  "emails": [/* array of email objects */],
  "count": 10,
  "query": "from:newsletter"  // only for search
}

unread Response

Copy{
  "unread_count": 5,
  "emails": [/* first 10 unread emails */]
}

send Response

Copy{
  "sent": true,
  "message_id": "18abc456",
  "thread_id": "18abc123"
}

thread Response

Copy{
  "thread_id": "18abc123",
  "messages": [/* array of messages with to/from */],
  "count": 3
}

Error Handling

Setup

1. Get OAuth credentials:

   • Go to Google Cloud Console
   • Create a project and enable Gmail API
   • Create OAuth 2.0 credentials (Desktop application)
   • Download credentials.json

2. Place credentials:

   Copymkdir -p ~/.fgp/auth/google
   mv credentials.json ~/.fgp/auth/google/
   

3. Start daemon:

   Copyfgp start gmail
   

4. Authorize (first run only):

   • Browser opens for Google OAuth
   • Grant permissions
   • Token saved automatically

Troubleshooting

Logs location: ~/.fgp/services/gmail/logs/

Performance

Tips for best performance:

• Keep daemon running (warm calls are fastest)
• Use limit parameter to reduce payload size
• Batch related queries when possible