Task Manager for ChatGPT

A powerful task management application that integrates seamlessly with ChatGPT through the OpenAI Apps SDK. Manage your tasks naturally through conversation and get things done without leaving your chat.

🌟 Features

• Natural Language Task Management: Create, update, and manage tasks using simple chat commands
• Smart Organization: Automatically categorize and prioritize tasks based on context
• Real-time Updates: See your task list update in real-time within ChatGPT
• Rich Visual Interface: Interactive widgets for better task visualization
• Cross-platform: Access your tasks from any device with ChatGPT

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• OpenAI Developer Account with Apps SDK access
• ChatGPT account with app development access

Local Development

1. Clone the repository:

   git clone https://github.com/sholajegede/chatgpt-task-manager-app.git
   cd chatgpt-task-manager-app
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:

   cp .env.local.example .env.local
   # Update the environment variables in .env.local
   

4. Run the development server:

   npm run dev
   

� Deploy to Vercel

Deploy your Task Manager with one click:

Manual Deployment

1. Push your code to a GitHub repository
2. Import the repository to Vercel
3. Set up the required environment variables
4. Deploy!

�🔧 Configuration

Environment Variables

Create a .env.local file with the following variables:

# Required for local development
NEXT_PUBLIC_APP_NAME=TaskManager
NEXT_PUBLIC_APP_DESCRIPTION="Your AI-powered task management assistant"
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Required for production
NEXT_PUBLIC_VERCEL_URL=${VERCEL_URL}
NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL=${VERCEL_PROJECT_PRODUCTION_URL}

# Add your OpenAI API key if needed
# OPENAI_API_KEY=your_openai_api_key

🛠️ Development

Project Structure

.
├── app/
│   ├── api/              # API routes
│   ├── mcp/              # Model Context Protocol implementation
│   ├── components/       # Reusable React components
│   ├── lib/              # Shared utilities and services
│   └── types/            # TypeScript type definitions
├── public/               # Static files
└── tests/                # Test files

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm start - Start production server
• npm test - Run tests
• npm run lint - Run ESLint

🤖 Integration with ChatGPT

This app integrates with ChatGPT using the OpenAI Apps SDK, allowing users to manage tasks through natural language. The MCP server exposes several tools that can be called from within ChatGPT.

Example Commands

• "Add a task to buy groceries tomorrow at 5pm"
• "Show me my tasks for today"
• "Mark 'Finish project' as complete"
• "What's my most important task?"

� How It Works

1. Tool Invocation: ChatGPT calls a tool registered in app/mcp/route.ts
2. Task Processing: The MCP server processes the task and updates the database
3. Widget Rendering: Task lists and details are rendered in interactive widgets
4. Real-time Updates: The UI updates automatically when tasks change

�📚 Documentation

For detailed documentation on the OpenAI Apps SDK and MCP server implementation, please refer to:

• OpenAI Apps SDK Documentation
• Model Context Protocol (MCP) Reference
• Widget Development Guide
• Next.js Documentation

🤝 Contributing

Contributions are welcome! Please follow these steps:

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

📄 License

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

---

Built with ❤️ using Next.js and the OpenAI Apps SDK

const nextConfig: NextConfig = {
  assetPrefix: baseURL,  // Prevents 404s on /_next/ files in iframe
};

Without this, Next.js will attempt to load assets from the iframe's URL, causing 404 errors.

3. CORS Middleware (middleware.ts)

Handles browser OPTIONS preflight requests required for cross-origin RSC (React Server Components) fetching during client-side navigation:

export function middleware(request: NextRequest) {
  if (request.method === "OPTIONS") {
    // Return 204 with CORS headers
  }
  // Add CORS headers to all responses
}

4. SDK Bootstrap (app/layout.tsx)

The <NextChatSDKBootstrap> component patches browser APIs to work correctly within the ChatGPT iframe:

What it patches:

• history.pushState / history.replaceState - Prevents full-origin URLs in history
• window.fetch - Rewrites same-origin requests to use the correct base URL
• <html> attribute observer - Prevents ChatGPT from modifying the root element

Required configuration:

<html lang="en" suppressHydrationWarning>
  <head>
    <NextChatSDKBootstrap baseUrl={baseURL} />
  </head>
  <body>{children}</body>
</html>

Note: suppressHydrationWarning is currently required because ChatGPT modifies the initial HTML before the Next.js app hydrates, causing hydration mismatches.

Getting Started

Installation

npm install
# or
pnpm install

Development

npm run dev
# or
pnpm dev

Open http://localhost:3000 to see the app.

Testing the MCP Server

The MCP server is available at:

http://localhost:3000/mcp

Connecting from ChatGPT

1. Deploy your app to Vercel using the button below:

   

2. After deployment, copy your deployed URL (e.g., https://your-app.vercel.app)

3. In ChatGPT, navigate to Settings → Connectors → Create and add your MCP server URL with the /mcp path (e.g., https://your-app.vercel.app/mcp)

Note: Connecting MCP servers to ChatGPT requires developer mode access. See the connection guide for setup instructions.

Project Structure

app/
├── mcp/
│   └── route.ts          # MCP server with tool/resource registration
├── layout.tsx            # Root layout with SDK bootstrap
├── page.tsx              # Homepage content
└── globals.css           # Global styles
middleware.ts             # CORS handling for RSC
next.config.ts            # Asset prefix configuration

How It Works

1. Tool Invocation: ChatGPT calls a tool registered in app/mcp/route.ts
2. Resource Reference: Tool response includes templateUri pointing to a registered resource
3. Widget Rendering: ChatGPT fetches the resource HTML and renders it in an iframe
4. Client Hydration: Next.js hydrates the app inside the iframe with patched APIs
5. Navigation: Client-side navigation uses patched fetch to load RSC payloads

Learn More

• OpenAI Apps SDK Documentation
• OpenAI Apps SDK - MCP Server Guide
• Model Context Protocol
• Next.js Documentation

Deployment

This project is designed to work seamlessly with Vercel deployment. The baseUrl.ts configuration automatically detects Vercel environment variables and sets the correct asset URLs.

The configuration automatically handles:

• Production URLs via VERCEL_PROJECT_PRODUCTION_URL
• Preview/branch URLs via VERCEL_BRANCH_URL
• Asset prefixing for correct resource loading in iframes