Todo Assistant with AI and Google Calendar Integration
@mertadali
AI-powered todo assistant with Google Calendar integration using OpenAI's API and Model Context Protocol (MCP) support for natural language task management.
Overview
What is Todo Assistant with AI and Google Calendar Integration?
A modern, AI-powered todo list and calendar management application that combines OpenAI's Assistant API with Google Calendar integration. Built with TypeScript, it features both MCP (Model Context Protocol) and traditional REST API endpoints, with multi-language support for English and Turkish.
How to use Todo Assistant with AI and Google Calendar Integration?
Clone the repository, install dependencies with npm install, configure environment variables (OpenAI API key, Google OAuth credentials), then run the server with npm start or npm run dev. The MCP endpoint is at /mcp; the REST API is available at /api/. Use the AI chat interface or standard HTTP calls to manage todos and calendar events.
Key features of Todo Assistant with AI and Google Calendar Integration
- AI-powered natural language chat interface (OpenAI GPT-3.5 Turbo)
- Smart todo management (add, remove, list, toggle)
- Google Calendar integration via OAuth 2.0
- Multi-language support (English and Turkish)
- Tool approval system for secure operations
- MCP (Model Context Protocol) for standardized AI tool interactions
Use cases of Todo Assistant with AI and Google Calendar Integration
- Add and manage todos using natural language commands
- Schedule calendar events by speaking dates and times
- List and update todos in English or Turkish
- Securely approve sensitive operations (e.g., sync to Google Calendar)
- Retrieve chat history and tool responses via API
FAQ from Todo Assistant with AI and Google Calendar Integration
What runtime and dependencies are required?
Node.js v16 or higher, npm or yarn, a SQLite database, an OpenAI API key, and a Google Cloud Console account with OAuth 2.0 credentials.
How does the application store data?
It uses SQLite via better-sqlite3 with two tables: todos (id, text, completed, createdAt) and calendar_events (id, todoId, title, date, time, createdAt).
What AI model does it use?
It uses OpenAI's GPT-3.5 Turbo through the Assistant API for natural language understanding and response generation.
How does Google Calendar integration work?
After configuring OAuth 2.0 credentials in the Google Cloud Console, the application authenticates and syncs todo events to Google Calendar based on user commands.
What transport protocols are available?
The server supports both MCP (Model Context Protocol) at the /mcp endpoint and traditional REST API endpoints at /api/. MCP is enabled with npm run dev:mcp.