@aidd-app/mcp

Official AiDD MCP Web Connector - ADHD-optimized productivity platform accessible from Claude web, mobile, and desktop.

🌐 Universal Access

Works everywhere Claude works:

• ✅ Claude.ai (desktop browsers)

• ✅ Claude mobile apps (iOS/Android)

• ✅ Claude Desktop (all platforms)

• ✅ ChatGPT Apps (with rich UI widgets)

Simply connect via URL - no local installation required.

Features

📝 Notes Management

• List, read, create, update, and delete notes in your AiDD account

• Full-text search and pagination

• Categorization (work/personal) and tags

• Batch delete support

✅ Action Items (AI-Powered)

• AI Extraction: Extract action items from notes or text using Google Gemini

• List, read, update, and delete action items with priority/due dates

• Confidence scoring for each extracted item

• Batch delete support

🎯 ADHD-Optimized Tasks

• AI Task Breakdown: Convert action items into manageable subtasks

  • Automatic time estimates

  • Energy level requirements

  • Dependency tracking

  • Task type classification

• AI Prioritization: Smart task scoring

  • Urgency × Importance × Energy × ADHD compatibility

  • Time-of-day optimization

  • Personalized recommendations

• Full CRUD: Create, read, update, and delete tasks

• Batch delete support

🚀 Async AI Processing

• AI operations run in background by default for better UX

• No timeout issues for large data sets

• New: check_ai_jobs tool to monitor job progress in real-time

• Check results with list_tasks or list_action_items

• Optional waitForCompletion parameter for small batches

⚡ Auto AI Scoring (New in v4.3.22)

For paid users (PRO/PREMIUM), AI scoring is automatically triggered after task conversion:

• MCP: Always auto-scores after conversion

• Web/iOS: Auto-scores when converting more than 1 action item

This means your tasks are immediately prioritized without needing a separate scoring step!

🖼️ ChatGPT UI Widgets (New in v4.4.0)

Rich interactive widgets for ChatGPT Apps integration:

Widgets are served as MCP resources with text/html+skybridge MIME type for native ChatGPT integration.

🔐 Authentication

• Browser-based OAuth (Google, Microsoft, Apple)

• Email/password sign-in

• Automatic token refresh

• Secure cloud storage

📱 Integrations

• Google Tasks

• Microsoft To Do

• Trello, Todoist, Notion

• TickTick, Evernote

Quick Start

Production URL: https://mcp.aidd.app/mcp

1. Open claude.ai → Settings

2. Navigate to "Connectors" or "MCP"

3. Click "Add Connector"

4. Enter URL: https://mcp.aidd.app/mcp

5. Save

That's it! Now use it:

📚 Realistic Usage Examples

Example 1: Morning Task Planning with Energy Levels

Scenario: You want to plan your workday based on your current energy level.

Example 2: Meeting Notes to Action Items

Scenario: You just finished a team meeting and have raw notes to process.

Example 3: Converting Action Items to ADHD-Friendly Tasks

Scenario: You have action items but need them broken down into manageable steps.

Example 4: Monitoring AI Job Progress

Scenario: You started a large conversion and want to check progress.

Example 5: Updating and Deleting Items

Scenario: You need to modify or clean up your task list.

Example 6: Weekly Review and Planning

Scenario: End of week review to see accomplishments and plan ahead.

Available Tools

Notes (5 tools)

Action Items (5 tools)

Tasks (7 tools)

AI Jobs (1 tool)

Authentication (1 tool)

Total: 18 tools (9 read-only, 6 write, 3 destructive)

Architecture

ChatGPT Apps Integration

Tech Stack

• Runtime: Node.js 20

• Framework: Express.js

• Protocol: MCP over HTTP/SSE (Streamable HTTP Transport)

• Transport: Server-Sent Events

• Auth: OAuth 2.0 with PKCE (S256)

• AI: Google Gemini 2.5 Pro & 2.5 Flash

Testing the Connector

You can verify the connector is running:

Subscription Tiers

PRO Plans: $4.99/month or $49.99/year (save $10)

Upgrade at: https://aidd.app/upgrade

Security & Privacy

Authentication & Data Protection

Compliance

Privacy Policy

AiDD processes your notes, tasks, and action items to provide AI-powered productivity features. We take your privacy seriously:

What We Collect

• Account Information: Email address, authentication tokens

• Content Data: Notes, action items, tasks you create or import

• Usage Data: Feature usage for improving the service (anonymized)

How We Use Your Data

• AI Processing: Notes → Action items → Tasks (on-demand only)

• Storage: Encrypted in your personal account

• Analytics: Anonymized usage patterns (opt-out available)

What We DON'T Do

• ❌ No AI Training: Your data is NEVER used to train AI models (including Google Gemini)

• ❌ No Selling: Your data is NEVER sold to third parties

• ❌ No Advertising: No targeted ads based on your content

• ❌ No Retention: AI processing is ephemeral, not stored in AI systems

Your Rights

• Access: Export all your data at any time

• Deletion: Request complete data deletion (GDPR Article 17)

• Portability: Download your data in standard formats

• Correction: Update or correct your information

• Objection: Opt-out of non-essential processing

Data Processing Details

Security Measures

• 🔐 End-to-end encryption for sensitive data

• 🔒 Secrets management via Google Secret Manager

• 🛡️ DDoS protection via Cloud Armor

• 📝 Audit logging with 30-day retention

• 🔍 Regular security audits and penetration testing

📋 Full Privacy Policy: https://aidd.app/privacy 📜 Terms of Service: https://aidd.app/terms

For Anthropic Reviewers

Test Account

A dedicated test account is available for Anthropic MCP review:

Full testing instructions: TEST_CREDENTIALS.md

Pre-loaded Test Data

• 16 Notes - Various categories and tags

• 13 Action Items - Mixed priorities with confidence scores

• 13 Tasks - All with AI scores (relevance, impact, urgency)

Support During Review

• Email: marc@aidd.app

• Subject: "Anthropic MCP Review - [Issue]"

• Response Time: < 2 hours (9am-6pm PST)

Troubleshooting

"Connection Failed"

1. Check health: curl https://mcp.aidd.app/health

2. Verify URL: https://mcp.aidd.app/mcp

3. Try removing and re-adding the connector

"Authentication Error"

1. Browser popup blocked? Allow popups for claude.ai

2. Try incognito mode (clear cookies)

3. Check if test account credentials are correct

"Rate Limit Exceeded"

• Check quota with status tool

• Upgrade at https://aidd.app/upgrade

Why Web Connector?

vs Desktop Extension:

vs Separate MCPs:

• Combine AiDD with other MCP connectors

• Example: Use with Apple Notes MCP for macOS

• Claude orchestrates between multiple MCPs automatically

Support

• 🌐 Website: aidd.app

• 📧 Email: support@aidd.app

• 🐛 Issues: GitHub

• 📚 Docs: docs.aidd.app

Contributing

Contributions welcome! See CONTRIBUTING.md

License

MIT © AiDD Team

Changelog

v4.4.0 (2025-12-19)

• 🖼️ New: ChatGPT UI Widgets - Rich interactive components for ChatGPT Apps

  • Task Priority Dashboard with AI scores

  • Action Item Extraction Preview with confidence

  • Energy-Based Task Selector

  • Quick Capture Form

  • Dependency Graph visualization

  • Focus Mode timer

  • AI Scoring Results Card

• 📦 New: MCP Resources for UI widgets (aidd://widgets/*)

  • Self-contained HTML with inlined CSS/JS

  • text/html+skybridge MIME type for ChatGPT integration

  • Tool-to-widget linking via _meta.ui_template

• 🔧 Architecture: UI bundled directly into MCP server

  • No separate hosting required

  • Automatic discovery by ChatGPT Apps

• 📊 Total tools: 18 (unchanged) + 8 widget resources

v4.3.22 (2025-12-02)

• 🔍 New Tool: check_ai_jobs - Monitor AI job progress in real-time

  • Check specific job by ID or list all active jobs

  • Shows job type, status, progress percentage, and timestamps

  • Provides helpful next steps based on job status

• ⚡ Auto AI Scoring: Paid users (PRO/PREMIUM) now get automatic task scoring after conversion

  • MCP: Always auto-scores after task conversion

  • Web/iOS: Auto-scores when converting more than 1 action item

  • No separate scoring step needed - tasks are prioritized automatically

• 📊 Total tools: 17 → 18

v4.3.18 (2025-11-30)

• 🔗 Cascade Delete: delete_action_items now automatically deletes all tasks derived from those action items

  • Prevents orphaned tasks when cleaning up action items

  • Response shows count of both deleted action items and derived tasks

v4.3.7 (2025-11-28)

• 🔒 Security: Added MCP safety annotations to all 20 tools

  • readOnlyHint: true for read-only operations (list_, read_, status)

  • destructiveHint: true for delete operations (delete_notes, delete_action_items, delete_tasks)

  • readOnlyHint: false, destructiveHint: false for write operations

• 🔐 OAuth: Added Claude callback URLs to allowlist (localhost:6274, claude.ai, claude.com)

• 🌐 HEAD: Added HEAD request handlers for OAuth endpoints

v4.1.1 (2025-11-25)

• ✏️ New: update_note - Update existing notes (title, content, tags, category)

• 🗑️ New: delete_notes - Delete one or more notes (batch support)

• ✏️ New: update_action_item - Update action items (title, priority, due date, completed status)

• 🗑️ New: delete_action_items - Delete one or more action items (batch support)

• ✏️ New: update_task - Update tasks (title, energy, time, type, completed status)

• 🗑️ New: delete_tasks - Delete one or more tasks (batch support)

• 📊 Total tools: 11 → 17

v4.1.0 (2025-11-24)

• 🚀 New: Async mode for AI operations (default)

• ⚡ Improved: convert_to_tasks runs in background, no timeout issues

• ⚡ Improved: score_tasks runs in background, handles large task lists

• 🔧 New: waitForCompletion parameter for synchronous mode

• 📝 Improved: Better response messages with "check in 2-3 minutes" guidance

v4.0.2 (2025-11-24)

• 📚 Docs: Added 5 realistic usage examples for Anthropic review

• 🔒 Privacy: Enhanced privacy policy section with full details inline

• 🐛 Fix: AI scores display (relevance, impact, urgency)

• 🐛 Fix: Task scoring deviceId requirement

v4.0.0 (2025-01-22) - Web Connector Edition

• 🌐 Breaking: Transitioned from stdio to HTTP/SSE transport

• 📱 New: Universal access (web, mobile, desktop)

• ☁️ New: Hosted service with auto-scaling

• 🔒 Enhanced: CORS for Claude domains

• ❌ Removed: Apple Notes integration (use separate MCP)

• ⚡ Improved: Cloud-native observability

v3.0.0 (2025-01-15)

• CRUD-based architecture

• 11 comprehensive tools

• Direct backend integration

• Enhanced AI features

v2.0.0 (2025-01-10)

• Browser-based OAuth

• Multi-provider sign-in

v1.0.0 (2025-01-05)

• Initial release

Made with ❤️ by the AiDD Team for the ADHD community

Transform your notes into actionable tasks, from anywhere, on any device.