UBOS Asset Marketplace: Calendar AutoAuth MCP Server for Enhanced AI Integration

In the rapidly evolving landscape of AI-driven automation, integrating AI assistants with everyday tools is becoming increasingly crucial. The UBOS platform offers a robust solution for this need through its Asset Marketplace. One standout asset is the Calendar AutoAuth MCP Server, designed to seamlessly integrate Google Calendar with Claude Desktop, enabling powerful, natural language-driven calendar management.

What is an MCP Server?

Before diving into the specifics of the Calendar AutoAuth MCP Server, let’s clarify what an MCP (Model Context Protocol) server is. MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools. This interaction empowers AI assistants to perform real-world tasks, such as managing calendar events, sending emails, or controlling smart home devices.

The Calendar AutoAuth MCP Server leverages this protocol to facilitate interactions between Claude Desktop and Google Calendar, streamlining event management and scheduling.

Use Cases for the Calendar AutoAuth MCP Server

The Calendar AutoAuth MCP Server unlocks a myriad of use cases, significantly enhancing productivity and workflow automation.

• Automated Meeting Scheduling: Imagine being able to schedule meetings simply by instructing your AI assistant in natural language. The Calendar AutoAuth MCP Server makes this a reality. Users can create, update, or delete events without ever opening the Google Calendar interface.
• Intelligent Reminders: Leverage the power of AI to create intelligent reminders. The server can analyze your schedule and proactively remind you of upcoming events, factoring in travel time, meeting preparation, and other contextual elements.
• Streamlined Collaboration: Coordinate schedules with team members effortlessly. The AI assistant can access and display team calendars, find optimal meeting times, and automatically send out invitations.
• Event Detail Retrieval: Quickly retrieve event details using natural language queries. Ask your AI assistant for the time, location, or agenda of an upcoming meeting, and the server will fetch the information from Google Calendar.
• Personalized Calendar Management: Tailor your calendar management experience to your specific needs. The server can learn your preferences and automatically categorize events, set priorities, and suggest optimal meeting times.

Key Features of the Calendar AutoAuth MCP Server

The Calendar AutoAuth MCP Server boasts a comprehensive set of features designed to simplify and automate Google Calendar management:

• Create Calendar Events: Easily create events with specified titles, times, descriptions, and locations using natural language commands.
• Retrieve Event Details: Fetch event details by event ID, allowing for quick access to specific information.
• Update Existing Events: Modify event details such as title, time, description, and location with simple commands.
• Delete Events: Remove events effortlessly, keeping your calendar clean and organized.
• List Events: Retrieve a list of events within a specified time range, providing a comprehensive overview of your schedule.
• Full Google Calendar API Integration: Seamlessly integrates with the Google Calendar API, ensuring compatibility and reliability.
• Simple OAuth2 Authentication: Employs a straightforward OAuth2 authentication flow with automatic browser launch for ease of setup.
• Desktop and Web Application Credentials Support: Supports both Desktop and Web application credentials, offering flexibility in deployment.
• Global Credential Storage: Securely stores credentials globally for convenient access from any location.
• Docker Support: Offers Docker support for containerized deployment, enhancing portability and scalability.

Installation and Authentication

The Calendar AutoAuth MCP Server can be installed and configured in several ways, catering to different user preferences and technical expertise.

Installing via Smithery

Smithery provides a streamlined installation process, allowing users to quickly deploy the server with minimal effort:

bash npx -y @smithery/cli install @raghavared/calendar-mcp --client claude

Manual Installation and Authentication

For users who prefer a more hands-on approach, the server can be installed and authenticated manually:

1. Create a Google Cloud Project and Obtain Credentials:

   • Go to the Google Cloud Console.
   • Create a new project or select an existing one.
   • Enable the Google Calendar API for your project.
   • Create OAuth 2.0 Credentials:
     • Go to “APIs & Services” > “Credentials”.
     • Click “Create Credentials” > “OAuth client ID”.
     • Choose either “Desktop app” or “Web application” as the application type.
     • Give it a name and click “Create”.
     • For Web application, add http://localhost:3000/v2/auth/google/callback to the authorized redirect URIs.
     • Download the JSON file of your client’s OAuth keys.
     • Rename the key file to token.json.

2. Run Authentication:

   • Global Authentication (Recommended):

     bash

     First time: Place token.json in your home directory’s .calendar-mcp folder

     mkdir -p ~/.calendar-mcp mv token.json ~/.calendar-mcp/

     Run authentication from anywhere

     npx @raghavared/calendar-mcp auth

   • Local Authentication:

     bash

     Place token.json in your current directory

     The file will be automatically copied to global config

     npx @raghavared/calendar-mcp auth

   The authentication process will:

   • Look for token.json in the current directory or ~/.calendar-mcp/.
   • If found in the current directory, copy it to ~/.calendar-mcp/.
   • Open your default browser for Google authentication.
   • Save credentials as ~/.calendar-mcp/credentials.json.

   Note:

   • After successful authentication, credentials are stored globally in ~/.calendar-mcp/ and can be used from any directory.
   • Both Desktop app and Web application credentials are supported.
   • For Web application credentials, make sure to add http://localhost:3000/v2/auth/google/callback to your authorized redirect URIs.

3. Configure in Claude Desktop:

   { “mcpServers”: { “calendar”: { “command”: “npx”, “args”: [ “@raghavared/calendar-mcp” ] } } }

Docker Support

For users who prefer containerized deployments, Docker support is available:

1. Authentication:

   bash docker run -i --rm –mount type=bind,source=/path/to/token.json,target=/token.json -v mcp-calendar:/path -e CALENDAR_OAUTH_PATH=/token.json -e “CALENDAR_CREDENTIALS_PATH=/path/credentials.json” -p 3000:3000 mcp/calendar auth

2. Usage:

   { “mcpServers”: { “calendar”: { “command”: “docker”, “args”: [ “run”, “-i”, “–rm”, “-v”, “mcp-calendar:/path”, “-e”, “CALENDAR_CREDENTIALS_PATH=/path/credentials.json”, “mcp/calendar” ] } } }

Usage Examples

The server provides several tools that can be used through the Claude Desktop:

Create Event

{ “summary”: “Team Meeting”, “start”: { “dateTime”: “2024-01-20T10:00:00Z” }, “end”: { “dateTime”: “2024-01-20T11:00:00Z” }, “description”: “Weekly team sync”, “location”: “Conference Room A” }

List Events

{ “timeMin”: “2024-01-01T00:00:00Z”, “timeMax”: “2024-12-31T23:59:59Z”, “maxResults”: 10, “orderBy”: “startTime” }

Update Event

{ “eventId”: “event123”, “summary”: “Updated Meeting Title”, “start”: { “dateTime”: “2024-01-20T11:00:00Z” }, “end”: { “dateTime”: “2024-01-20T12:00:00Z” } }

Delete Event

{ “eventId”: “event123” }

Security Considerations

Security is paramount when integrating AI assistants with sensitive data. The Calendar AutoAuth MCP Server incorporates several security measures to protect user data:

• Secure Credential Storage: OAuth credentials are stored securely in the user’s local environment (~/.calendar-mcp/).
• Offline Access: The server utilizes offline access to maintain persistent authentication without requiring constant re-authentication.
• Credential Protection: Users are strongly advised never to share or commit their credentials to version control systems.
• Regular Access Review: Users should regularly review and revoke unused access in their Google Account settings.
• Local Accessibility: Credentials are stored globally but are only accessible by the current user.

Troubleshooting Tips

Encountering issues is inevitable in any software deployment. Here are some common troubleshooting tips for the Calendar AutoAuth MCP Server:

1. OAuth Keys Not Found:
   • Ensure token.json is in either your current directory or ~/.calendar-mcp/.
   • Check file permissions.
2. Invalid Credentials Format:
   • Ensure your OAuth keys file contains either web or installed credentials.
   • For web applications, verify the redirect URI is correctly configured.
3. Port Already in Use:
   • If port 3000 is already in use, please free it up before running authentication.
   • You can find and stop the process using that port.

UBOS: The Future of AI Agent Development

The Calendar AutoAuth MCP Server is just one example of the powerful assets available on the UBOS platform. UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create sophisticated Multi-Agent Systems.

By leveraging UBOS, businesses can:

• Accelerate AI Agent Development: Reduce development time and costs with pre-built components and a streamlined workflow.
• Enhance AI Agent Performance: Connect AI Agents with relevant data sources and tools to improve accuracy and efficiency.
• Scale AI Agent Deployments: Easily deploy and manage AI Agents across multiple environments.
• Unlock New Business Opportunities: Explore new use cases and revenue streams with AI-powered automation.

The UBOS Asset Marketplace provides a rich ecosystem of tools and resources to empower AI developers and businesses alike. Explore the marketplace today and discover how UBOS can transform your organization with the power of AI Agents.

Contributing to the Project

Contributions to the Calendar AutoAuth MCP Server are welcome! If you have ideas for new features, bug fixes, or improvements, please feel free to submit a Pull Request on the GitHub repository.

License

This project is licensed under the ISC License, promoting open-source collaboration and innovation.

Support and Community

If you encounter any issues or have questions about the Calendar AutoAuth MCP Server, please file an issue on the GitHub repository. The community is active and ready to assist with any challenges you may face.

Conclusion

The Calendar AutoAuth MCP Server represents a significant step forward in AI-driven calendar management. By seamlessly integrating Google Calendar with Claude Desktop, this server empowers users to automate tasks, streamline workflows, and enhance productivity. As part of the UBOS Asset Marketplace, it exemplifies the power of AI Agents to transform the way we work and interact with technology. Explore the possibilities today and unlock the full potential of AI-powered automation with UBOS.