home / mcp / aidd mcp server

AiDD MCP Server

Official AiDD MCP Web Connector - ADHD-optimized productivity platform with AI-powered task management, accessible from Claude web, mobile, and desktop

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aidd-app-mcp-server": {
      "url": "https://mcp.aidd.app/mcp"
    }
  }
}

You deploy and use the AiDD MCP Web Connector to bring ADHD-optimized productivity features into Claude-based apps across web, mobile, and desktop. This server exposes a REST-like MCP interface that lets you access notes, action items, and ADHD-friendly tasks, while letting you run AI-powered processing in the background for smooth, scalable productivity workflows.

How to use

Connect your MCP client to the hosted AiDD MCP Web Connector at the production URL and authenticate to enable access to notes, action items, and tasks. You can then create notes, extract action items from text or notes, convert those items into ADHD-optimized tasks, and have AI scoring run automatically where your plan supports it. Use the available tools to list, read, create, update, or delete items, and monitor ongoing AI jobs to track progress in real time.

How to install

Prerequisites: Node.js 20 or a compatible runtime, and network access to the internet.

Clone the project and install dependencies.

git clone https://github.com/aidd-app/mcp-server
cd mcp-server
npm install

How to install

Run the MCP server locally using the command shown in the repository setup flow when available. If you want to start a local instance for testing, use the standard Node.js startup pattern shown in the project flow.

Extra configuration and usage notes

The hosted MCP server is accessible at the production URL https://mcp.aidd.app/mcp. You can validate connectivity and basic endpoints with health checks and endpoint discovery commands.

Security and access

Authentication is handled via OAuth 2.0 with PKCE and browser-based sign-in options, plus token refresh for seamless user sessions. All communication with the MCP server occurs over HTTPS.

Testing the connector

# Health check
curl https://mcp.aidd.app/health

# MCP endpoint info
curl https://mcp.aidd.app/mcp

# OAuth discovery
curl https://mcp.aidd.app/.well-known/oauth-authorization-server

Usage examples

Use the MCP tools to manage notes, action items, and tasks. For example, extract action items from notes, convert them to ADHD-optimized tasks, and then score and prioritize those tasks automatically (where your plan allows). You can also monitor AI jobs as they progress and check results with list tools.

Notes on integration with ChatGPT Apps

ChatGPT Apps can discover MCP resources and render UI widgets that map to MCP tools. Widgets include a task dashboard, action items view with confidence scores, energy-based task selectors, quick capture forms, dependency graphs, focus timers, and AI scoring insights. Widgets are served as MCP resources with a text/html+skybridge MIME type for native integration.

Troubleshooting

If you encounter connectivity issues, verify the health endpoint and the MCP URL, or reconfigure the connector. If authentication fails, check that popup blockers are disabled for the Claude domains and try a fresh sign-in.

Additional content

The server architecture organizes Claude users, the MCP bridge, and the AiDD Backend with cloud-native components to support scalable, low-latency AI processing. See the security and privacy sections for details on data handling, storage, and compliance.

What you can run against the hosted server

Note: All commands below target the hosted MCP server. Use the production URL for live usage.

Examples of common workflows

Morning planning, meeting follow-ups, and weekly reviews can be automated by extracting action items from notes, converting them to ADHD-optimized tasks, and applying AI scoring. Use the available tools to fetch notes, process items, and retrieve the prioritized task list.

Available tools

list_notes

Browse notes in your AiDD account with sorting by created/updated/title and read access to individual notes.

read_note

Read a specific note by its ID.

create_note

Create a new note with a title, content, tags, and category.

update_note

Update an existing note's title, content, tags, or category.

delete_notes

Delete one or more notes by ID (batch support).

list_action_items

Browse action items with sorting and filter options.

read_action_item

Read a specific action item by ID.

extract_action_items

AI-powered extraction of action items from notes or text.

update_action_item

Update an existing action item (title, priority, due date, etc.).

delete_action_items

Delete action items and, if applicable, their derived tasks.

list_tasks

Browse tasks with AI scores and related metadata.

read_task

Read a specific task by ID.

create_task

Create a new task manually.

convert_to_tasks

Convert action items to ADHD-optimized tasks (async).

score_tasks

AI-powered prioritization of tasks (async).

update_task

Update an existing task (title, energy, time, completed, etc.).

delete_tasks

Delete one or more tasks by ID.

check_ai_jobs

Monitor AI job progress (extraction, conversion, scoring).

status

Check authentication status and account info.