googlecontacts_get_tablesLABSCO SUMMARY
Contacts as a queryable table rather than a scrolling list.
The CData JDBC Driver exposes Google Contacts as relational models, so a question like "who do I have at this company" becomes a SELECT rather than a search box. Connecting uses OAuth in the browser during driver setup, and the server stays read-only afterwards — nothing here edits or deletes a contact.
What it is
A Java MCP server that puts CData's JDBC Driver for Google Contacts behind three read-only tools: list the tables, list a table's columns, and run a SQL SELECT. The driver is what does the work — it exposes Google Contacts as relational SQL models — and the server hands those models to your client so you can ask questions in plain language instead of writing SQL yourself.
What you get
get_tablesreturns the tables available in the data source, as CSV with a header rowget_columnsreturns the columns of one table, in the same CSV shaperun_queryexecutes a SQL SELECT and returns the rows- Every tool name starts with the
Prefixin your.prpfile (googlecontacts_in the sample), so several CData servers can run side by side without colliding - Ask in plain language and the client picks the tools and writes the SQL itself
Requirements
Build the server with mvn clean install, which produces CDataMCP-jar-with-dependencies.jar. Separately download the CData JDBC Driver for Google Contacts and license it: run java -jar cdata.jdbc.googlecontacts.jar --license and enter your name, email and either TRIAL or a licence key. Then write a .prp file naming DriverClass=cdata.jdbc.googlecontacts.GoogleContactsDriver plus the JdbcUrl you build in the driver's connection-string utility, and point your client at java -jar with the jar and that file. Transport is stdio, so the server has to run on the same machine as the client.
Setup effort
Build from source — clone the repository, then point your client at the binary
USE CASES
Finding everyone from one organisation
Ask for the group and let the client filter the contacts table instead of scrolling.
Auditing what fields are actually filled in
List the columns, then query for the rows with gaps you care about.
Building a one-off list for an email
Describe the criteria; the answer comes back as CSV you can paste elsewhere.
3 tools
Listed in project docs. Your client may show a different list.
googlecontacts_get_columnsgooglecontacts_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. Tool names start with the Prefix in your .prp file, so the sample Prefix=googlecontacts gives googlecontacts_get_tables, googlecontacts_get_columns and googlecontacts_run_query. All three only read. The Tables setting does not limit what the tools reach; your connection's access does.
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Clone the repository, then point your client at the binary. This one is built from source rather than installed with a single command.
Server setup
git clone https://github.com/cdatasoftware/google-contacts-mcp-server-by-cdata.git
cd google-contacts-mcp-server-by-cdata
mvn clean installDownload and install the CData JDBC Driver for Google Contacts from https://www.cdata.com/drivers/googlecontacts/download/jdbc
License the driver: java -jar cdata.jdbc.googlecontacts.jar --license (enter name, email, and "TRIAL" or a license key)
Run java -jar cdata.jdbc.googlecontacts.jar with no arguments to open the Connection String utility, test the connection, copy the connection string
Write a .prp file (e.g. google-contacts.prp) containing Prefix=googlecontacts, ServerName, ServerVersion, DriverPath, DriverClass=cdata.jdbc.googlecontacts.GoogleContactsDriver, JdbcUrl, Tables
Tables only picks which tables also get a ready-made description for your assistant, and empty means none; the server can still list and query every table your connection string reaches, so to keep data out of reach, limit that connection or the account it signs in with.
Add the mcpServers entry below to claude_desktop_config.json, pointing java at CDataMCP-jar-with-dependencies.jar and at the .prp file, then fully quit and reopen the client
MCP Clients
Claude Desktop — Windows, macOS/Linux
{
"mcpServers": {
"google-contacts": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_GOOGLE_CONTACTS>"
]
}
}
}