MCP Documentation

Model Context Protocol

Use MoodLens To-Do from compatible AI clients

Connect ChatGPT, Claude, and other compatible AI clients to your authorized MoodLens workspace through the remote MCP server.

· Production connector · Secure workspace authorization

Server endpoint https://moodlenstodo.com/api/mcp
Production

What you can do

The connector exposes authorized workspace tools for tasks, documents, boards, sprints, comments, subtasks, and time tracking.

  • Review and search current workspace tasks.
  • Read and manage documents and structured blocks.
  • Work with boards, columns, and sprints.
  • Add comments, subtasks, and task time entries.

Setup

  1. Add https://moodlenstodo.com/api/mcp as a remote MCP connector.
  2. Sign in through the MoodLens OAuth screen.
  3. Choose a workspace where you are an owner or administrator.
  4. Review and authorize the requested read and write scopes.

Opening the endpoint directly in a browser may show a blank successful health response. MCP clients use negotiated JSON or text/event-stream responses instead.

Authentication and access

MoodLens uses OAuth 2.1-compatible dynamic client registration, S256 PKCE, resource-bound tokens, and least-privilege scope challenges. You choose the workspace and approve the requested permissions during authorization.

Write actions

Creating, updating, publishing, archiving, or deleting workspace records changes MoodLens data. Review the target and requested change before approving a write or destructive action.

Data boundary

The connector receives tool arguments and returns records from the workspace and scopes you authorize. It does not request the AI client's memory, unrelated chat history, or files that were not selected for a MoodLens operation.

Never paste a credential into a chat message or public document.

Working examples

Review and prioritize work

“Show my open tasks, identify the three highest-priority items, and explain what is blocked.”

The connector reads the authorized workspace's tasks and returns a focused summary without changing anything.

Create a structured workspace document

“Create a project launch brief in MoodLens with goals, milestones, risks, and a checklist.”

The connector creates a native MoodLens document with visible editor blocks and returns its document ID.

Create and organize a task

“Create a high-priority task called ‘Prepare launch review’, add a rich description and three subtasks, then place it in the To Do column.”

The connector creates the task, applies supported rich formatting, adds subtasks, and confirms the resulting task record.

Update an existing workflow

“Find the launch review task, mark the first subtask complete, add a progress comment, and move the task to In Progress.”

The connector locates the task and performs only the requested changes after the client's normal write-tool approval.

Technical discovery

OAuth clients can discover the protected resource metadata and authorization server metadata automatically.

Production availability

This is the production, generally available MoodLens connector. It runs over HTTPS on managed cloud infrastructure, uses bounded tool responses, and provides a dedicated support channel.