home / mcp / google contacts mcp server

Google Contacts MCP Server

This read-only MCP Server allows you to connect to Google Contacts data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cdatasoftware-google-contacts-mcp-server-by-cdata": {
      "command": "java",
      "args": [
        "-jar",
        "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
        "/PATH/TO/google-contacts.prp"
      ]
    }
  }
}

This MCP Server provides a local, read-only interface to Google Contacts data via the Model Context Protocol. It exposes live data through a simple MCP API so you can ask natural language questions and receive up-to-date results from Google Contacts without writing SQL.

How to use

You run a local MCP client that connects to the Java-based MCP server on the same machine. The server exposes three core capabilities for Google Contacts data: list available tables, list columns for a table, and execute read-only queries. In practice, you load the Google Contacts data through the MCP server and then ask your AI client to read data, answer questions about contacts, deduplicate lists, or analyze fields like names, emails, or groups. All data remains read-only in this configuration, so you can safely query live data without modifying anything.

How to install

# Prerequisites
java -version
mvn -version

# 1) Clone the MCP server project
git clone https://github.com/cdatasoftware/google-contacts-mcp-server-by-cdata.git
cd google-contacts-mcp-server-by-cdata

# 2) Build the server into a runnable JAR
mvn clean install
# This creates CDataMCP-jar-with-dependencies.jar

# 3) Install the CData JDBC Driver for Google Contacts
# Download from: https://www.cdata.com/drivers/googlecontacts/download/jdbc

# 4) License the JDBC Driver (example paths; adjust to your install)
# Windows
# java -jar cdata.jdbc.googlecontacts.jar --license
# Mac/Linux
# java -jar cdata.jdbc.googlecontacts.jar --license

# 5) Configure a JDBC connection and generate a .prp file (example shown below)
# Run the connection string utility to obtain the JDBC URL, then create google-contacts.prp as described later
```} ,{

6) Create the props file for the MCP server (google-contacts.prp) using the fields shown in the example below. This file tells the MCP server how to connect to Google Contacts through the CData JDBC Driver.

Extra configuration steps

Prefix=googlecontacts
ServerName=CDatagooglecontacts
ServerVersion=1.0
DriverPath=PATH\\TO\\cdata.jdbc.googlecontacts.jar
DriverClass=cdata.jdbc.googlecontacts.googlecontactsDriver
JdbcUrl=jdbc:googlecontacts:InitiateOAuth=GETANDREFRESH;
Tables=

The above defines the prefix used by tools, the server name, the driver path and class, and the JDBC URL you obtain from the Connection String utility. Leave Tables blank to access all data, or specify specific tables if you want restricted access.

Running the server

Start the MCP server locally on the same machine as your client. Use the final command that launches the server with your .prp file.

java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/google-contacts.prp

Usage notes

Once running, your AI client can use the built-in tools to explore the data and perform read-only queries. You can list available tables, inspect columns, and run SELECT-like queries against Google Contacts through the MCP server. The server runs locally via stdio, so you’ll interact with it from a client that executes on the same computer.

Troubleshooting

If the MCP server does not appear in your client, ensure you have fully stopped and restarted your client after starting the server. Verify the Java process is running and that the path to google-contacts.prp is correct. If the client cannot retrieve data, double-check the JDBC connection details and re-run the Connection String utility to refresh the JDBC URL. For further help, reach out to the CData Support Team.

Notes on licensing and data access

This setup provides read-only access to Google Contacts data. If you require write or delete capabilities, consider a different MCP server configuration that supports full data manipulation.

Available tools

googlecontacts_get_tables

Retrieves a list of tables available in Google Contacts data. The output is CSV with column headers on the first line.

googlecontacts_get_columns

Retrieves a list of columns for a specified table. The output is CSV with column headers on the first line.

googlecontacts_run_query

Executes a SQL-like SELECT query against Google Contacts and returns the results.