Skip to main content

Weekly Review Tools

Tools for managing the weekly review process, a core GTD practice.

Personal Reviews

Weekly reviews are personal to each user. Review pages, prompts, and reflections are private and visible only to the user who created them. This ensures honest self-reflection without concerns about visibility to teammates.

Available Tools​

review_ensure_page​

Ensure a weekly review page exists for the current week. Creates the page with standard GTD sections if it doesn't exist.

{
  "name": "review_ensure_page",
  "arguments": {
    "workspace_id": "ws_123",
    "space_id": "space_456"
  }
}

Response:

{
  "page": {
    "id": "page_review_2024w03",
    "title": "Weekly Review - Jan 15-21, 2024",
    "weekNumber": 3,
    "year": 2024,
    "sections": [
      "Get Clear",
      "Get Current",
      "Get Creative"
    ],
    "status": "created",
    "url": "/spaces/space_456/pages/page_review_2024w03"
  }
}

review_create_prompts​

Create review prompts/questions for the user to reflect on during their weekly review.

{
  "name": "review_create_prompts",
  "arguments": {
    "workspace_id": "ws_123",
    "space_id": "space_456",
    "questions": [
      "What were your biggest wins this week?",
      "What tasks kept getting deferred and why?",
      "Are there any projects that need to be put on hold?"
    ],
    "source": "agent"
  }
}

Response:

{
  "prompts": [
    {
      "id": "prompt_001",
      "question": "What were your biggest wins this week?",
      "source": "agent",
      "status": "pending",
      "weekNumber": 3,
      "createdAt": "2024-01-15T10:00:00Z"
    },
    {
      "id": "prompt_002",
      "question": "What tasks kept getting deferred and why?",
      "source": "agent",
      "status": "pending",
      "weekNumber": 3,
      "createdAt": "2024-01-15T10:00:00Z"
    },
    {
      "id": "prompt_003",
      "question": "Are there any projects that need to be put on hold?",
      "source": "agent",
      "status": "pending",
      "weekNumber": 3,
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ]
}

review_list_pending​

List pending review prompts for the current week that haven't been addressed yet.

{
  "name": "review_list_pending",
  "arguments": {
    "workspace_id": "ws_123",
    "space_id": "space_456"
  }
}

Response:

{
  "prompts": [
    {
      "id": "prompt_002",
      "question": "What tasks kept getting deferred and why?",
      "source": "agent",
      "status": "pending",
      "weekNumber": 3,
      "createdAt": "2024-01-15T10:00:00Z"
    }
  ]
}

Review Sections​

The weekly review page follows the GTD methodology with three main sections:

SectionPurpose
Get ClearProcess inbox, capture loose ends, empty your head
Get CurrentReview projects, update task statuses, check calendar
Get CreativeBrainstorm new ideas, review someday/maybe list

Prompt Sources​

SourceDescription
agentPrompts generated by an AI agent based on activity
systemStandard GTD review prompts
userCustom prompts created by the user

Example: Agent-Assisted Review​

// Ensure review page exists for this week
const page = await mcp.call("review_ensure_page", {
  workspace_id: "ws_123",
  space_id: "space_456"
});

// Analyze user's week and generate personalized prompts
const deferredTasks = await mcp.call("tasks_list", {
  workspace_id: "ws_123",
  status: "todo",
  updated_before: "2024-01-08"  // Tasks untouched for a week
});

const prompts = [];
if (deferredTasks.tasks.length > 5) {
  prompts.push("You have several tasks that haven't moved in a week. Are these still relevant?");
}

// Create the prompts
await mcp.call("review_create_prompts", {
  workspace_id: "ws_123",
  space_id: "space_456",
  questions: prompts,
  source: "agent"
});

// Later, check what's still pending
const pending = await mcp.call("review_list_pending", {
  workspace_id: "ws_123",
  space_id: "space_456"
});

console.log(`${pending.prompts.length} prompts still need reflection`);