Connect Google Gemini & Gemini Tasks
What it is
Connect your thanks.io account directly to Google Gemini—including free personal Google accounts and Gemini Tasks—using the official thanks.io remote MCP server (https://mcp.thanks.io/mcp). Once connected, you can analyze campaign performance, design postcards with ThanksAI Studio, preview Targeted Leads, and send postcards, letters, notecards, MagnaCards, and gift cards using plain English.
Before you start: requirements & account limits
You do not need a paid Gemini subscription to connect thanks.io. Make sure your Google and thanks.io accounts meet these requirements:
- Google account type - a standard personal Google account (
@gmail.com). Google Workspace work or school accounts may not have the consumer Custom apps menu enabled. - Region & language - age 18+ in the United States, with Gemini's language set to English.
- Gemini activity turned on - Keep Activity (Gemini History) must be switched On in Gemini settings. The Custom apps option is disabled if activity history is off.
- Desktop browser for initial setup - add the custom MCP server on the Gemini web app first. Once connected, it works across Gemini web, mobile, and Gemini Tasks.
- thanks.io account - any active thanks.io account. Authentication uses OAuth 2.0 sign-in, so no manual API key pasting is required.
Gemini Tasks quota comparison
Google sets task and schedule limits by Gemini plan:
| Feature / Capability | Free Personal Account | Google AI Pro |
|---|---|---|
MCP Connection (https://mcp.thanks.io/mcp) | Included | Included |
| Concurrent Tasks | Up to 15 running at once | Higher limit allocations |
| Scheduled Tasks | Up to 10 active schedules (daily general window) | Up to 50 active schedules (exact hourly/minute timing) |
Google's Custom apps feature and Gemini Tasks limits are managed by Google and may vary by account as features roll out.
Step 1: Connect thanks.io inside Gemini
- Open gemini.google.com in a desktop web browser.
- Click the Settings gear icon in the bottom-left corner, then go to Connected Apps (or Personal Intelligence → Connected apps, depending on your interface).
- Under Custom apps, click + Custom (or Add a custom app).
- Paste the official thanks.io remote MCP endpoint:
https://mcp.thanks.io/mcp
- Leave any optional OAuth client credential fields blank—thanks.io handles OAuth 2.0 registration automatically.
- Sign in to your thanks.io account when prompted and approve access.
- Test the connection: Open a new chat or switch to Task mode, type
@in the prompt box, select thanks.io, and ask:
Give me an overview of my thanks.io account.
You can also view the Gemini setup steps anytime in your thanks.io dashboard under Integrations & API → AI Assistants → Connect Your AI → Gemini.
Google rolls out Custom Apps incrementally across personal accounts. If you meet all requirements above and don't see + Custom yet, check back in a few days.
Step 2: Set your safety & spending permissions in thanks.io
The thanks.io MCP server includes 57 specialized tools organized into three safety tiers so you stay in full control of your account and budget:
| Tool Tier | Included Functions | Financial Impact & Safety Controls |
|---|---|---|
| Read Tools (26 tools) | View account balances, QR scan performance, mailing lists, handwriting styles, saved templates, creatives, and marketing playbooks. | Always safe. Never edits account settings or spends credits. |
| Write Tools (16 tools) | Generate ThanksAI Studio artwork, save image and message templates, create mailing lists, preview Targeted Leads counts, draft paused campaigns, and cancel orders. | Free modifications. Never charges your account or dispatches physical mail. |
| Sensitive / Spending Tools (15 tools) | Send postcards, letters, notecards, MagnaCards, or gift cards; activate recurring campaigns; pay for email-to-address lookups; buy Targeted Leads; create or update Lead Feeds; manage webhooks. | Spending blocked by default. Paid sends, campaign activation, and lead purchases require explicit toggle activation in dashboard settings. |
Previewing an order with preview-order renders front/back proofs and calculates the exact total without charging your account, and adding recipients with full mailing addresses is free—both work before you enable any spending toggles.
Enable ordering or lead purchases when you're ready
- Log in to your thanks.io dashboard and navigate to Settings → API & MCP Access (click your name in the top right → API & MCP Access under Developer). If a sub-account is active, switch to your main account first.
- Review the two switches on the MCP Permissions card (both are OFF by default):
- Allow orders via MCP - turn ON when you want Gemini to place live mail orders or turn on recurring campaigns.
- Allow lead purchases via MCP - turn ON if you want Gemini to look up mailing addresses for email-only contacts (7¢ per address found), buy one-time Targeted Leads (10¢ per lead added), or start, resume, or raise spend on Lead Feeds (10¢ per new lead added).
See MCP Permissions for full details on what works with each switch off.
:::tip Start in Test Mode Turn on Test Mode in the API Settings card on Settings → API & MCP Access while learning. Test Mode automatically cancels mail orders placed through MCP so you can test end-to-end prompts and inspect proofs (stamped DRAFT on Free and Business plans) without printing physical mail or paying per-piece charges.
Keep in mind that Test Mode does not make lead purchases free: email address lookups and Targeted Leads or Lead Feeds remain charged as usual while Test Mode is on. Leave Allow lead purchases via MCP switched OFF while testing. See API Test Mode. :::
Built-in safeguards
- Duplicate protection: thanks.io automatically rejects duplicate identical mail orders within a 2-minute window, and rejects identical Targeted Leads purchases or Lead Feed starts within 24 hours.
- Rate limits: Connected assistants can place up to 10 orders per minute, make up to 120 requests per minute, and start up to 20 Targeted Leads previews per hour through MCP.
- 1-hour cancellation window: Submitted orders enter a 1-hour review window before printing begins—ask Gemini to cancel an order or cancel it on the Orders page in your dashboard.
Ready-to-use prompt library
Copy any prompt below, replace the [bracketed placeholders] with your details, and type @thanks.io at the start so Gemini invokes your thanks.io connection.
Category 1: Account intelligence & performance audits (Read-only)
1. Complete account health briefing
@thanks.io Give me a full overview of my account. Include my current credit balance, plan tier, test mode status, active MCP permissions, active campaigns, and my top 3 and bottom 3 performing creatives.
2. QR scan & ROI performance breakdown
@thanks.io Analyze my direct mail performance over the last [90 days]. Break down QR scan rates, gift card redemptions, and total spend by mailer type, creative, and campaign. Highlight what's working best and recommend 3 specific optimizations.
3. Verify whether a specific address was mailed
@thanks.io Did we send any postcard, letter, or notecard to [742 Evergreen Terrace, Springfield] in the last [60 days]? Check my recent recipients and tell me the mailer type and send date if found.
Category 2: AI design & handwritten copy with ThanksAI Studio (Free write tools)
4. Design a new postcard front with ThanksAI Studio
@thanks.io Use ThanksAI Studio to design a 6x9 postcard front for a [Spring HVAC Tune-Up Special — $79 inspection for homeowners]. Make it clean, high-contrast, with a bold headline and clear call-to-action. Show me the design so we can refine it, then save it as a reusable creative template.
5. Convert an uploaded design's QR code into a tracked thanks.io QR
@thanks.io Save this front image URL [paste image URL] as a new image template named '[Spring Promo Front]', and convert the QR code on the artwork into a tracked thanks.io QR code pointing to [https://yourdomain.com/offer] so every scan is logged.
6. Create a realistic handwritten back-side message template
@thanks.io First, show me your available realistic handwriting styles and recommend one that looks warm and personal. Then create a saved message template named '[VIP Check-In Note]' using that handwriting style with this message: 'Hey %FIRST_NAME% — just wanted to say thanks for being part of our community this year. Scan the QR code for a quick gift on us! — [Your Name]'
Category 3: Targeted Leads, neighbor mailings & Lead Feeds
7. Preview Targeted Leads before spending a dime
@thanks.io Preview how many targeted leads are available in [zip code 17401 / Austin, TX] matching [single-family homeowners / local small business owners]. Show me the estimated count and total cost—do not purchase them yet.
8. Real estate "Just Listed / Just Sold" neighbor play
@thanks.io I just [listed / sold] a home at [123 Oak Street, City, ST] ([paste listing URL or 3 key stats: 4 bed, 3 bath, $525,000]). Please:
1. Design a 4x6 postcard front featuring a bold 'JUST [LISTED/SOLD]' headline and the key property details.
2. Write a short, warm handwritten-style message for the back inviting neighbors to scan the QR code for an instant home value estimate at [your landing page URL].
3. Check my '[Neighbor List Name]' mailing list (or preview Targeted Leads for homeowners in ZIP code [12345]).
4. Stop and show me the front/back proof and total cost for my approval before buying leads or sending mail.
:::tip Street-level neighbor lists To pull the exact nearest neighbors around a specific street address, run a Radius Search in your thanks.io dashboard first to populate a mailing list, then ask Gemini to mail that list. :::
9. Launch an automated intent Lead Feed ($0.10/net-new lead)
@thanks.io Search available intent lead topics related to [roofing / solar / mortgage refinance / moving]. Show me the best matching topics and daily/weekly volume estimates, then help me configure a Lead Feed with a [weekly] limit of [25 leads per run]—pause before activating so I can approve.
Category 4: Sending mailers, MagnaCards & gift cards (With guardrails)
10. Send a campaign to an existing mailing list (Proof first)
@thanks.io Prepare to send my '[Open House Postcard]' creative to my '[Austin Sellers]' mailing list. Show me the recipient count, a visual proof of the front and back, and the exact total cost first. Do not place the order until I reply 'Approved'.
11. High-impact B2B or VIP gift card outreach
@thanks.io List available gift card brands in the coffee and lunch categories. Then draft a handwritten-style notecard with a [$10 Starbucks] gift card to [Sarah Martinez, 418 Oak Ridge Ln, Austin, TX 78704] thanking her for taking our call today. Show me the proof and total price before sending.
12. Send a fridge-magnet MagnaCard to stay top-of-mind
@thanks.io Help me prepare a MagnaCard (fridge magnet postcard) order for my '[Past Clients]' list using my '[MagnaCard Creative Name]' creative (or front image URL [paste image URL]) and a tracked QR code to [your website]. Preview the order and total cost first.
ThanksAI Studio generates fronts for postcards, notecards, gift cards, and letters, not MagnaCards—upload or save a MagnaCard front image in Creatives first, or pass an existing image template or URL.
13. Build an automated birthday or retention drip (Leave paused)
@thanks.io Set up a recurring birthday card campaign for my '[VIP Clients]' mailing list using a handwritten-style notecard and a [$10 coffee] gift card. Leave the campaign paused so I can review everything inside my thanks.io dashboard before turning it on.
Category 5: Direct mail strategy & playbooks
14. Pull proven direct mail playbooks & benchmarks
@thanks.io Call your marketing playbook tool for [real estate expired listings / absentee homeowners / e-commerce win-back / insurance renewals]. Summarize the recommended multi-touch sequence, timing between touches, and typical response benchmarks.
15. Plan a structured A/B split test
@thanks.io Look at my top-performing postcard from the last 6 months and propose an A/B split test to beat its QR scan rate. Suggest two distinct headline/offer variations, recommend whether to test 6x9 postcards vs. MagnaCards, and draft both message templates as free drafts.
Category 6: Automated workflows with Gemini Tasks (Scheduled)
Switch Gemini to Task mode to run recurring direct mail operations on autopilot (works on free personal accounts up to 10 active schedules, or Google AI Pro up to 50 schedules):
16. Weekly direct mail performance & low-credit alert
Every Monday morning, check @thanks.io for my account credit balance and past-7-day performance. Send me a short summary with total pieces sent, QR scan count, top-performing creative, and flag me immediately if my credit balance is under [$50].
17. Monthly seasonal campaign prep
On the 1st of each month, review my @thanks.io past campaign performance and draft 2 fresh seasonal postcard concepts (front design idea + handwritten back copy) tailored to [my industry] for me to review and approve.
Category 7: Agencies & multi-client teams (Sub-accounts)
18. Audit or draft across client sub-accounts
@thanks.io List all of my sub-accounts. Then pull a 30-day performance summary and credit balance check for [Client Name]'s sub-account only, without touching any other sub-account.
Best practices for safe, high-converting results
- Always ask for proofs and pricing first - add
"Show me the proof and total cost before sending"to any prompt that triggers mail or lead purchases. - Use Test Mode for your first send - verify your designs, merge fields (
%FIRST_NAME%, custom fields, QR links), and workflow end-to-end before switching Test Mode off. Remember that Test Mode does not make lead purchases free. - Keep spending toggles OFF until needed - if you only want Gemini to analyze QR scans, pull playbooks, and design creatives in ThanksAI Studio, leave Allow orders via MCP and Allow lead purchases via MCP switched OFF.
- Use the 1-hour cancel window if needed - if you ever approve an order by mistake, ask Gemini to cancel it right away (
cancel-order) or cancel it inside your thanks.io dashboard before printing starts.