MCP Server OpenAI Chat

🚀 AI-Powered To-Do Assistant Integrated with Google Calendar

A modern, AI-based to-do list and calendar management application that combines OpenAI's Assistant API with Google Calendar integration. Developed using TypeScript and integrated with MCP (Model Context Protocol) and traditional API endpoints.

Main interface of the To-Do Assistant

Main interface of the To-Do Assistant

Main interface of the To-Do Assistant

✨ Features

• AI Chat Interface: Enables natural language interaction using OpenAI's GPT-3.5 Turbo.
• Intelligent To-Do Management: Allows adding, deleting, listing, and marking to-dos via natural language.
• Google Calendar Integration: Seamlessly synchronizes to-dos with Google Calendar.
• Multi-Language Support: Fully supports English and Turkish.
• Tool Approval System: Implements a secure approval process for sensitive operations.
• Model Context Protocol (MCP): Enhances the AI interaction experience.

🛠️ Technology Stack

📦 Installation

1. Clone the project repository:

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. Install dependencies:

   npm install
   

3. Configure environment variables. Create and populate the .env file:

   PORT=3001
   MONGODB_URI=mongodb://localhost:27017/todo_assistant
   GOGLE_CALENDAR_API_KEY=Your Google Calendar API Key
   OPENAI_API_KEY=Your OpenAI API Key
   

4. Start the application:

   npm start
   

📁 Project Structure

src/
├── components/          # React components
│   ├── TodoList.js     # To-Do List component
│   ├── CalendarWidget.js  # Calendar Widget component
│   └── ApprovalWorkflow.js  # Tool Approval Workflow component
├── services/           # Service modules
│   ├── todoService.js    # To-Do business logic
│   ├── calendarService.js  # Calendar integration service
│   └── openaiService.js   # OpenAI API calls
├── reducers/          # Redux state management
│   ├── todoReducer.js     # To-Do state management
│   ├── calendarReducer.js  # Calendar state management
│   └── approvalReducer.js  # Approval Workflow state management
└── App.jsx           # Main application component

💻 Usage Examples

Basic Usage

# English commands
Add "Complete project proposal" to my todos.
Remove "Old tasks" from my calendar.
Show me all my upcoming events this week.
Mark "Meeting with client" as completed.
Update the project deadline to next Friday.
Sync my todos with Google Calendar.
Approve the calendar update request.

# Turkish commands
"Proje teklifini tamamla" görevine ekle.
"Esik işler" gitki listemden sil.
Bu hafta gelen tüm eventleri göster.
"Client'a randevu" görevini tamam olarak İşaretle.
Proje deadline'ı下周 Çarşamba gününe güncelle.
Todo'larımı Google Calendar ile senkronize et.
Calender güncelme talebine onay ver.

🔒 Security Features

• Tool approval workflow for sensitive operations
• Google Calendar OAuth 2.0 authentication
• Secure credential management
• Input validation and sanitization

🌐 Google Calendar Setup

1. Visit Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Calendar API
4. Configure OAuth 2.0 credentials:
   • Set the application type to "Web application"
   • Add the authorized redirect URI: http://localhost:3001/google/callback
   • Download the credentials and update the .env file

🤝 Contribution Guidelines

1. Fork the project repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

• The OpenAI team for their powerful Assistant API
• The Google Calendar API team
• All contributors and testers

📞 Support

For support, open an issue in the GitHub repository or contact the maintainers.