1. Astravue MCP Server
Astravue docs
  • Astravue API & MCP
  • Auth
    • Get Access and Refresh Token
      POST
    • Refresh Access Token
      POST
  • Personal Tasks
    • Get task by ID
      GET
    • Update a task
      PUT
    • Delete a task
      DELETE
    • Get all tasks
      GET
    • Create a task
      POST
  • Spaces
    • Get space by ID
      GET
    • Update a space
      PUT
    • Delete a space
      DELETE
    • Get all spaces
      GET
    • Create a new space
      POST
  • Projects
    • Get project details by ID
      GET
    • Update a project
      PUT
    • Delete a project
      DELETE
    • Get all projects in a space
      GET
    • Create a new project
      POST
  • Project Tasks
    • Get a project task by ID
      GET
    • Update a project task
      PUT
    • Delete a project task
      DELETE
    • Get all tasks in a project
      GET
    • Create a project task
      POST
  • Task Timer
    • Get active timers for a user
    • Update a timer
    • Delete a timer entry
    • Stop timer for a task
    • Start timer for a personal task
    • Add a time range entry for a personal task
    • Add manual time entry for a personal task
    • Start timer for a project task
    • Add range timer for a project task
    • Add manual time entry for a project task
    • Get timers for a user in a task
    • Get global timesheet report
    • Get project timesheet
    • Get project timesheet summary
  • Task Comments
    • Get comments for a task
  • Project Subtasks
    • Get all subtasks for a project task
  • Personal Subtasks
    • Get all subtasks for a personal task
  • Tasks Checklist
    • Get all checklists for a subtask
    • Get all checklists for a parent task
  • Astravue MCP Server
    • Overview
    • Get started
    • Supported tools
    • Authentication & Security
    • Integrating your own MCP client
  • Schemas
    • Schemas
      • ApiError
      • TimerData
      • NotificationReadResponseDto
      • FieldError
      • TimerUpdateRequest
      • NotificationDto
      • ApiSuccessResponseListTaskCheckListDto
      • TimeTrackerDto
      • TaskCommentDto
      • TaskCheckListDto
      • TaskListResponse
      • TaskUpdateRequest
      • NotificationDeleteRequestDto
      • ApiSuccessResponseTaskDto
      • TimerRequest
      • NotificationDeleteResponseDto
      • ApiSuccessResponseListTaskCommentDto
      • CustomFieldOptionDto
      • RangeTimerRequest
      • ApiSuccessResponseSubtaskListResponse
      • OrgRoleDto
      • ManualTimerRequest
      • SubtaskListResponse
      • TaskCustomFieldDto
      • TaskTimerResponseDto
      • TaskDependencyDto
      • TaskDto
      • TaskFieldValue
      • TaskPriorityDto
      • TaskResponseDto
      • TaskStatusDto
      • TaskTagDto
      • UserDisplayDto
      • SpaceUpdateRequest
      • ApiSuccessResponseSpaceDto
      • SpaceDto
      • SpaceMemberDto
      • SpaceRoleDto
      • ProjectUpdateRequest
      • AccountLabelDto
      • ApiSuccessResponseProjectDto
      • ContactDto
      • ContactProperties
      • ContactTagDto
      • ProjectDto
      • ProjectHealthDto
      • ProjectMemberDto
      • ProjectPriorityDto
      • ProjectRoleDto
      • ProjectStatusDto
      • ProjectTagDto
      • ProjectTaskUpdateRequest
      • AppDto
      • ResponseFormat
      • OrgMemberDto
      • UserPreference
      • UserPreferenceProperties
      • PasswordUpdateDto
      • UserDetailDto
      • MemberPreferenceDto
      • WidgetProperties
      • TimeMapDto
      • TaskStatusTemplateDto
      • DefaultProjectTaskStatusesTemplateDto
      • EmailContent
      • AttachmentDto
      • ReminderModeDto
      • TaskReminderDto
      • DailyRecurrenceSettings
      • DaysAfterRecurrenceSettings
      • FieldsToInclude
      • MonthlyRecurrenceSettings
      • TaskRecurrenceDto
      • WeeklyRecurrenceSettings
      • YearlyRecurrenceSettings
      • TaskListDto
      • OrganizationDto
      • Address
      • BillingAndAccountInfo
      • Filter
      • FilterList
      • FilterViewDto
      • CalendarEvent
      • EventReminder
      • ContactNotesDto
      • ColumnPreferenceDto
      • ColumnPreferenceProperties
      • AccountDto
      • AccountTagDto
      • ContactLabelDto
      • TaskCreateRequest
      • SpaceCreateRequest
      • ProjectCreateRequest
      • ProjectTaskCreateRequest
      • FileUploadDto
      • GlobalTaskStatusesTemplateDto
      • PasswordResetDto
      • UserDto
      • InviteUserDto
      • UserActivity
      • UserActivityKey
      • ApiSuccessResponseTaskListResponse
      • ApiSuccessResponseProjectListResponse
      • ApiSuccessResponseListSpaceDto
      • ProjectListResponse
      • ApiSuccessResponseObject
      • BackupUserActivity
    • TimesheetReportResponse
    • ProjectTimesheetResponse
  1. Astravue MCP Server

Supported tools

Learn what your AI assistant can do with Astravue MCP tools.
Astravue MCP exposes workspace operations as tools that AI assistants can call.
Each tool performs a specific action in your Astravue workspace such as creating projects, managing tasks, logging time, or retrieving reports.
When an AI assistant receives a request, it selects the appropriate tool based on the user's prompt and executes it with the required parameters.
INFO
All tools require an active authenticated session.
If a tool call fails with 401 Unauthorized, reconnect your AI client to refresh your session.
WARNING
Some tools perform destructive actions such as deleting tasks, projects, or spaces.
Most AI clients require confirmation before executing these operations. Always review actions before approving them.

Permissions#

Astravue MCP respects the same role-based access control as the Astravue web app. Every tool call is executed as your authenticated user with your existing permissions. You cannot access or modify anything through MCP that you cannot access in the app.

Organization roles#

RoleMCP Access
Account AdminFull access to all spaces, projects, and tasks across the organization
AdminFull access to all spaces, projects, and tasks across the organization
ManagerCan manage spaces and projects they are a member of
MemberCan read and write within spaces and projects they belong to
GuestRead-only. Cannot perform any write operations through MCP

Space-level permissions#

ActionRequired role
List spaces, view space detailsSpace Member
Create, update, delete a spaceOrg Admin or Manager

Project-level permissions#

ActionRequired role
List tasks, view project detailsProject Member
Create or update tasksProject Member
Add project members, delete projectProject Admin
Manage custom fields, statusesProject Admin

Task-level permissions#

ActionRequired role
View tasks, comments, checklistsProject Member
Create tasks, add comments, log timeProject Member
Delete a taskTask Owner, Task Creator, or Project Admin
Delete a commentComment Creator or Org Admin
INFO
If a tool call returns 403 Access Denied, it means your account does not have the required role for that action. Contact your workspace admin to update your permissions.

Example workflow#

A user asks an AI assistant:
Create a new sprint called Sprint 5 and add tasks for login, payments, and API docs.
The AI assistant may execute these tools:
1.
astravue_create_project
2.
astravue_bulk_create_tasks
3.
astravue_update_task
This allows complex project setup to be completed from a single conversation.

MCP Tools#

Spaces
Projects
Tasks
Subtasks
Dependencies
Comments
Checklists
Time Tracking
Custom Fields
Task Statuses
Filters
Scheduled & Overdue Tasks
Notifications
Workspace & Members

Rate Limits#

Astravue MCP enforces rate limits to ensure platform stability.
Requests per user per minute100
Bulk task create limit100 tasks per call
If the limit is exceeded the server returns:
HTTP 429 Too Many Requests
Wait 60 seconds before retrying the request.
Previous
Get started
Next
Authentication & Security
Built with