How to Use the Google Contacts MCP in Mastra AI

Q: How does Mastra AI search Google Contacts using this MCP Server?

You register the searchcontacts tool to your agent instance. The agent then calls this tool whenever it needs to find specific record details.

Q: Can I use Mastra AI to sync Google Contacts to another database?

You can create a workflow that uses listcontacts to pull data and then pipes it to your target storage. The framework handles the data transformation steps.

Q: Does this MCP Server allow Mastra AI to handle Google Contacts group updates?

Yes, you can chain listcontactgroups with other tools to move records between groups. The agent handles the association logic based on your defined rules.

Automate your address book with Mastra AI and the Google Contacts MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Contacts MCP to Mastra AI

Create your Vinkius account to connect Google Contacts to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Google Contacts with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated contact workflows

Build agent workflows that use `list_contacts` to trigger downstream actions. Mastra AI handles the logic branches, such as checking if a contact exists before running a new task. If the API rate limits hit, the engine manages the retry logic automatically. You define the flow once, and the agent executes it until the contact record is updated.

Conditional contact pruning

Deploy an agent to audit your network using `delete_contact` only after a verification step. You can set up a workflow that flags stale entries for your review before the agent acts. This keeps your address book clean without manual effort. You maintain control by setting approval gates on every destructive operation.

Group-based organization

Organize your network by calling `create_contact_group` through your agent. You can map incoming leads to specific groups based on the context found in your emails. It removes the need for manual sorting. The agent analyzes the incoming data and places the contact in the correct bucket automatically.

Setup guide

Set up Google Contacts MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Google Contacts tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "google-contacts-mcp-client",
  servers: {
    "google-contacts-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Google Contacts Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Google Contacts tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Google Contacts transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Contacts. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Google Contacts now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Google Contacts MCP in Mastra AI

You register the `search_contacts` tool to your agent instance. The agent then calls this tool whenever it needs to find specific record details.

You can create a workflow that uses `list_contacts` to pull data and then pipes it to your target storage. The framework handles the data transformation steps.

Yes, you can chain `list_contact_groups` with other tools to move records between groups. The agent handles the association logic based on your defined rules.

The framework catches API errors and triggers your defined failure handlers. You can set up automatic retries for transient network issues.

The MCP Server runs in an ephemeral V8 sandbox. Your contact information is never persisted by the server and remains strictly under your control.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python