MCP Tools
All tools available through the Plenar MCP server at dashboard.plenar.app/mcp.
You do not need to memorize these. Claude knows about all available tools and will call the right one based on your natural language request. This reference is here for when you want to understand exactly what a tool does, what parameters it accepts, or what role it requires.
How tools work
Read-only tools return data immediately. No preview, no apply needed.
Write tools go through the change impact preview: they compute a schedule diff and return a pending_changes_id. You review the preview, then call plenar_apply_changes to commit. This is the same system the dashboard uses.
Role requirements: Planner tokens can do everything. Contributor tokens can preview but not apply.
Task Management
plenar_get_my_tasks
Get your assigned tasks, sorted by priority and schedule order. Returns tasks grouped by status (In Progress, To Do, Blocked, Done) with scheduled dates and estimates.
Read-only — no preview or apply needed.
Requires: Contributor or Planner
Example prompt: “What should I work on next?” or “Show me my tasks”
plenar_start_task
Mark a task as In Progress. Records today as the effective start date. Returns a schedule preview showing impact and a suggested_branch name for your git branch.
Plenar automatically claims the task for your session when you start it. The dashboard shows a “Claimed by” indicator so your team can see who is actively working on each task. If the task is assigned to someone else, the claim is skipped and Plenar suggests reassigning it or picking a different task.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “Start working on the auth middleware task”
plenar_complete_task
Mark a task as Done. Records today as the effective end date. Triggers a schedule recompute. Returns a preview showing impact and a next_suggested_task — your next prioritized assignment.
When you apply the completion, Plenar releases the task claim automatically.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “Mark the API endpoint task as done”
plenar_bulk_complete
Mark up to 50 tasks as completed in a single batch. Returns a single schedule diff and one pending_changes_id. Tasks that are not found or already completed are skipped and reported.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Complete tasks T-12, T-13, and T-14” or “Mark all the sprint 3 tasks as done”
plenar_delete_tasks
Delete tasks by ID. Always previewed first. Returns a diff showing freed capacity and earlier finish dates. Cascade-deletes dependency edges and unlinks artifacts. Does not delete empty milestones or goals.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Delete the deprecated logging tasks”
Planning
plenar_create_plan
Create a full plan with goals, milestones, and tasks in one call. At least one goal or task required. Returns a schedule preview. The most powerful tool for bootstrapping a project.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Create a plan for the billing integration with three milestones”
plenar_add_tasks
Add tasks to an existing plan. Dependencies can reference existing tasks by ID or title. Returns a schedule preview showing impact of the new tasks.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Add three tasks to the auth goal: login page, session storage, and token refresh”
plenar_create_goal
Create a single goal with optional priority and target date. Returns a schedule preview.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Create a P1 goal called API v2 Launch with a May 15th deadline”
plenar_create_milestone
Create a milestone, optionally assigned to a goal by title. Returns a schedule preview.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Add an OAuth milestone under the auth goal”
Schedule
plenar_apply_changes
Apply previously previewed changes to the plan of record. Takes the pending_changes_id from any write tool’s response. Persists changes and triggers a recompute.
Requires: Planner. Contributors can preview but not apply.
Example prompt: “Apply the changes” or “Commit the preview”
plenar_get_schedule_status
Get current schedule health: goal progress (on track / off track), warnings, and pending changes count.
Read-only.
Requires: Contributor or Planner
Example prompt: “Are any goals off track?” or “What’s the schedule health?”
plenar_update_estimate
Update effort estimate for a task. Returns a schedule preview showing how the estimate change ripples through the schedule.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “Change the auth task estimate from 3 to 5 days”
plenar_get_velocity_context
Get velocity and calibration data for the project: calibration factors, accuracy trends, and metrics. Use this before estimating new work.
Read-only.
Requires: Contributor or Planner
Example prompt: “How accurate have our estimates been?” or “What’s the team velocity?”
plenar_get_exemplars
Find completed tasks similar to a candidate task. Returns actual vs. estimated durations for calibration.
Read-only.
Requires: Contributor or Planner
Example prompt: “Find tasks similar to the payment integration for estimating”
Dependencies
plenar_add_dependency
Add a finish-to-start dependency between two tasks (source blocks target). Returns a schedule preview.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “The webhook handler depends on the API middleware”
plenar_remove_dependency
Remove a dependency between two tasks. Returns a schedule preview.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “Remove the dependency between auth and logging”
plenar_bulk_add_dependencies
Add multiple dependencies in one call with a single preview. Input is a map: keys are target task IDs (blocked), values are arrays of source task IDs (blockers).
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Set up dependencies: login depends on OAuth, OAuth depends on token storage, tests depend on both”
plenar_bulk_remove_dependencies
Remove multiple dependencies in one call with a single preview. Same input format as bulk add.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Planner
Example prompt: “Remove all dependencies between the logging tasks”
Blockers
plenar_report_blocker
Report a blocker on a task. Optionally specify a blocked_by_task_id. Returns a schedule preview showing impact and alternative tasks you can work on.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “I’m blocked on the API task — waiting for the database migration”
plenar_list_blockers
List what blocks the given tasks. Returns a map of task ID to blocker IDs.
Read-only.
Requires: Contributor or Planner
Example prompt: “What’s blocking the integration tests?”
plenar_list_blocking
List what the given tasks block (downstream dependents). Returns a map of task ID to blocked IDs.
Read-only.
Requires: Contributor or Planner
Example prompt: “What tasks depend on the auth middleware?”
Availability
plenar_add_time_off
Log time off for yourself. Specify start date, end date, and type (pto, sick, oncall, conference). For single-day time off, set start and end to the same date.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “I’m taking PTO next Friday” or “Mark me as on-call the week of April 14”
plenar_get_my_availability
Show your upcoming time off and availability. Defaults to the next 30 days. Optionally specify a date range.
Read-only.
Requires: Contributor or Planner
Example prompt: “Do I have any time off coming up?” or “Show my availability for April”
plenar_cancel_time_off
Cancel a time-off entry. Provide either an entry ID (from plenar_get_my_availability) or a specific date.
Returns a preview. Use plenar_apply_changes to commit.
Requires: Contributor or Planner
Example prompt: “Cancel my Friday PTO”
Artifacts and Search
plenar_link_artifact
Link an artifact to a task: PR, doc, design, test output, or note. Provide the task ID, artifact type, and URL.
Requires: Contributor or Planner
Example prompt: “Link this PR to the auth middleware task”
plenar_search
Search across tasks, goals, and milestones by free text or structured filters. Returns grouped results with pagination.
Read-only.
Requires: Contributor or Planner
Example prompt: “Find all tasks with ‘auth’ in the name” or “Which goal has the payment work?”