[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_114":115},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@astravueorg/astravue-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","astravueorg","moduleId","astravue-mcp-server","@astravueorg/astravue-mcp-server","displayName","Astravue MCP","tagline","Manage projects, tasks, time tracking, and team collaboration through natural language.","iconKey","https://app.astravue.com/astravue-1.svg","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://api.astravue.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363244000,"updatedAt",1781499365000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.astravue%2Fastravue-mcp","sourceVerified",false,"importedAt","upstreamStars",12,"upstreamUpdatedAt",1781015620000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/AstravueOrg/astravue-mcp-server","githubRepoFullName","AstravueOrg/astravue-mcp-server","releaseId","ext-astravueorg-astravue-mcp-server","version","1.0.1","descriptionMarkdown","

\n $\"Astravue\"$ \n

\n\n

\n $\"Website\"$ \n $\"Documentation\"$ \n $\"Latest$ \n $\"Apache$ \n $\"Official$ \n $\"Official$ \n $\"Listed$ \n $\"Listed$ \n $\"Listed$ \n $\"Claude$ \n

\n\n

\n $\"Install$ \n

\n\n# Astravue MCP Server\n\n

\n \n $\"Astravue$ \n \n
\n Click the image to download the full demo (with audio).\n

\n\nThe Astravue MCP Server is a cloud-based bridge between your [Astravue](https://astravue.com) workspace and compatible AI tools. Once configured, it enables those tools to interact with your spaces, projects, tasks, time entries, and custom fields in real time. All actions are authenticated via OAuth 2.0 and respect the user's existing access controls.\n\nWith the Astravue MCP Server, you can:\n\n* **Search and browse** spaces, projects, and tasks without switching tools.\n* **Create and update** tasks, subtasks, checklists, and comments through natural language.\n* **Track time** with live timers or manual entries and generate timesheet reports.\n* **Manage custom fields** including dropdowns, dates, currencies, and more.\n* **Automate workflows** like sprint planning, status reporting, and bulk task updates.\n\nIt's designed for project managers, developers, and teams who use AI-powered IDEs or assistants and want to manage work without context switching.\n\nFull product documentation lives at **[docs.astravue.com](https://docs.astravue.com)**.\n\n---\n\n## Supported Clients\n\nAll clients connect to the same endpoint: `https://api.astravue.com/mcp`\nYou will be asked to sign in to Astravue in your browser the first time you connect.\n\n| Client | Docs | Transport |\n| :----- | :--- | :-------- |\n| [Claude Code](#claude-code) | [MCP setup](https://code.claude.com/docs/en/mcp) | Streamable HTTP |\n| [Claude Desktop](#claude-desktop) | [MCP setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) | Streamable HTTP |\n| [Claude.ai (Web)](#claudeai-web) | [Remote MCP](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) | Streamable HTTP |\n| [Claude Mobile](#claude-mobile-ios--android) | — | Streamable HTTP |\n| [Cursor](#cursor) | [MCP setup](https://docs.cursor.com/context/model-context-protocol) | Streamable HTTP |\n| [VS Code](#vs-code) | [MCP setup](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) | Streamable HTTP |\n| [Windsurf](#windsurf) | [MCP setup](https://docs.windsurf.com/windsurf/cascade/mcp) | Streamable HTTP |\n| [Cline](#cline) | [MCP setup](https://docs.cline.bot/mcp/configuring-mcp-servers) | Streamable HTTP |\n| [JetBrains IDEs](#jetbrains-intellij-webstorm-pycharm-etc) | [MCP setup](https://www.jetbrains.com/help/ai-assistant/mcp.html) | Streamable HTTP |\n| [Gemini CLI](#gemini-cli) | [MCP setup](https://geminicli.com/docs/tools/mcp-server/) | Streamable HTTP |\n\n---\n\n## Setup Instructions\n\n### Claude Code\n\nYou have two installation options. **Option A** installs the full plugin (MCP server + eight productivity skills). **Option B** installs only the MCP server.\n\n#### Option A — Install as a Claude Code plugin (recommended)\n\nThe plugin bundles the MCP server with eight pre-built skills that automate common project management workflows. It is listed in Anthropic's community plugin marketplace.\n\nInside Claude Code, run:\n\n```text\n/plugin marketplace add anthropics/claude-plugins-community\n/plugin install astravue@claude-community\n/reload-plugins\n```\n\nAlternatively, install directly from this repository:\n\n```text\n/plugin marketplace add AstravueOrg/astravue-mcp-server\n/plugin install astravue@astravue\n/reload-plugins\n```\n\nAfter install, run `/mcp` to confirm **astravue** is connected, then open `/plugin` and switch to the **Installed** tab to view the bundled skills.\n\nSee Anthropic's [plugin discovery docs](https://code.claude.com/docs/en/discover-plugins) for installation scopes (user, project, local).\n\n#### Option B — Install only the MCP server\n\nIf you only want the raw MCP server without the bundled skills, run:\n\n```bash\nclaude mcp add --transport http astravue https://api.astravue.com/mcp\n```\n\nYour browser will open automatically. Sign in with your Astravue account and click **Approve**.\n\nTo confirm the connection, run `/mcp` in a new Claude Code session. You should see **astravue** listed with a green connected status.\n\n

Share connection across a project team

\n\nAdd the `--scope project` flag to create a `.mcp.json` file in your project root:\n\n```bash\nclaude mcp add --transport http --scope project astravue https://api.astravue.com/mcp\n```\n\nCommit `.mcp.json` to your repository so teammates automatically get the connection.\n\n

\n\n---\n\n### Claude Desktop\n\n> Requires a Claude Pro, Max, Team, or Enterprise plan.\n\n1. Go to **Settings → Connectors** in Claude Desktop.\n2. Click **Add custom connector** and enter: `https://api.astravue.com/mcp`\n3. Sign in with your Astravue account in the browser and click **Approve**.\n\n

Manual config file setup (advanced)

\n\nIf Connectors is not available in your Claude Desktop version, edit:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"astravue-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://api.astravue.com/mcp\"\n }\n }\n}\n```\n\nSave the file and restart Claude Desktop.\n\n

\n\n---\n\n### Claude.ai (Web)\n\n> Requires a Claude Pro, Max, Team, or Enterprise plan.\n\n1. Go to [claude.ai](https://claude.ai) → **Settings → Connectors**\n2. Click **Add connector** and enter: `https://api.astravue.com/mcp`\n3. Sign in with your Astravue account in the browser and click **Approve**.\n\n---\n\n### Claude Mobile (iOS / Android)\n\nClaude Mobile uses the same connector ecosystem as Claude.ai.\n\nAdd the connector on **Claude.ai (web)** or **Claude Desktop** first — it will automatically appear on your mobile app. No separate setup needed.\n\n---\n\n### Cursor\n\n1. Go to **Cursor Settings → Tools & MCP**\n2. Click **New MCP Server** — this opens your `mcp.json` file\n3. Add the following configuration:\n\n```json\n{\n \"mcpServers\": {\n \"astravue-mcp\": {\n \"url\": \"https://api.astravue.com/mcp\"\n }\n }\n}\n```\n\n4. Save the file. Your browser will open — sign in with your Astravue account and click **Approve**.\n\n

Project-level configuration

\n\nCreate a `.cursor/mcp.json` file in your project root with the same config above. This scopes the connection to that project only.\n\n

\n\n---\n\n### VS Code\n\n1. Add a `.vscode/mcp.json` file to your project root:\n\n```json\n{\n \"servers\": {\n \"astravue-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://api.astravue.com/mcp\"\n }\n }\n}\n```\n\n2. Open Command Palette (`Cmd+Shift+P` on macOS, `Ctrl+Shift+P` on Windows), run **MCP: List Servers**, and click **Start** next to `astravue-mcp`.\n3. Authenticate with your Astravue account in the browser.\n\n

User-level configuration (all projects)

\n\nAdd this to your **User Settings (JSON)**:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"astravue-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://api.astravue.com/mcp\"\n }\n }\n }\n}\n```\n\n

\n\n---\n\n### Windsurf\n\n1. Open the Windsurf MCP config file:\n * **macOS / Linux:** `~/.codeium/mcp_config.json`\n * **Windows:** `C:\\Users\\[username]\\.codeium\\mcp_config.json`\n * Or go to **Settings → Tools → Windsurf Settings → Add Server**\n\n2. Add the following:\n\n```json\n{\n \"mcpServers\": {\n \"astravue-mcp\": {\n \"serverUrl\": \"https://api.astravue.com/mcp\"\n }\n }\n}\n```\n\n> If you already have other servers in your config, add `astravue-mcp` alongside them inside the existing `mcpServers` object — don't replace the entire file.\n\n3. Reload Windsurf and authenticate with your Astravue account.\n\n---\n\n### Cline\n\n1. Click the **Cline icon** in the VS Code sidebar → click the **menu (⋮)** in the top right → select **MCP Servers**.\n2. Go to the **Remote Servers** tab and fill in:\n * **Server Name:** `astravue-mcp`\n * **Server URL:** `https://api.astravue.com/mcp`\n * **Transport Type:** `Streamable HTTP`\n3. Click **Add Server**. Your browser will open — sign in and click **Approve**.\n\n

Manual JSON configuration

\n\nClick **Configure MCP Servers** in the Configure tab to open `cline_mcp_settings.json` and add:\n\n```json\n{\n \"mcpServers\": {\n \"astravue-mcp\": {\n \"url\": \"https://api.astravue.com/mcp\",\n \"type\": \"streamableHttp\"\n }\n }\n}\n```\n\n

\n\n---\n\n### JetBrains (IntelliJ, WebStorm, PyCharm, etc.)\n\n1. Go to **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**\n2. Click **Add** → Select **Streamable HTTP** → Paste:\n\n```json\n{\n \"mcpServers\": {\n \"astravue-mcp\": {\n \"url\": \"https://api.astravue.com/mcp\"\n }\n }\n}\n```\n\n3. Click **OK**, then **Apply**. Sign in with your Astravue account in the browser.\n\n---\n\n### Gemini CLI\n\nCopy `gemini-extension.json` from this repository to your Gemini CLI extensions directory, or add the server URL to your Gemini MCP configuration.\n\n---\n\n### Other MCP Clients\n\nFor any client that supports **Streamable HTTP + OAuth 2.0**:\n\n| Setting | Value |\n| :------ | :---- |\n| Server URL | `https://api.astravue.com/mcp` |\n| Transport | Streamable HTTP |\n| Authentication | OAuth 2.0 (Authorization Code + PKCE) |\n\n

SSE-only clients (mcp-remote bridge)

\n\nIf your client only supports SSE transport, run:\n\n```bash\nnpx -y mcp-remote@latest https://api.astravue.com/mcp\n```\n\nPoint your client to the local mcp-remote process instead of the Astravue URL.\n\n

\n\n---\n\n## How It Works\n\nAstravue 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.\n\nWhen an AI assistant receives a request, it selects the appropriate tool based on the user's prompt and executes it with the required parameters.\n\n> **Authentication:** All tools require an active authenticated session. If a tool call fails with `401 Unauthorized`, reconnect your AI client to refresh your session.\n\n> **Destructive actions:** 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.\n\n---\n\n## Permissions\n\nAstravue 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.\n\n### Organization Roles\n\n| Role | MCP Access |\n| :--- | :--------- |\n| **Account Admin** | Full access to all spaces, projects, and tasks across the organization |\n| **Admin** | Full access to all spaces, projects, and tasks across the organization |\n| **Manager** | Can manage spaces and projects they are a member of |\n| **Member** | Can read and write within spaces and projects they belong to |\n| **Guest** | Read-only. Cannot perform any write operations through MCP |\n\n### Space-Level Permissions\n\n| Action | Required Role |\n| :----- | :------------ |\n| List spaces, view space details | Space Member |\n| Create, update, delete a space | Org Admin or Manager |\n\n### Project-Level Permissions\n\n| Action | Required Role |\n| :----- | :------------ |\n| List tasks, view project details | Project Member |\n| Create or update tasks | Project Member |\n| Add project members, delete project | Project Admin |\n| Manage custom fields, statuses | Project Admin |\n\n### Task-Level Permissions\n\n| Action | Required Role |\n| :----- | :------------ |\n| View tasks, comments, checklists | Project Member |\n| Create tasks, add comments, log time | Project Member |\n| Delete a task | Task Owner, Task Creator, or Project Admin |\n| Delete a comment | Comment Creator or Org Admin |\n\n> 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.\n\n---\n\n## Example Workflow\n\nA user asks an AI assistant:\n\n> *\"Create a new sprint called Sprint 5 and add tasks for login, payments, and API docs.\"*\n\nThe AI assistant may execute these tools:\n\n1. `astravue_create_project` — creates the Sprint 5 project\n2. `astravue_bulk_create_tasks` — creates the three tasks in one call\n3. `astravue_update_task` — sets priorities or due dates as needed\n\nThis allows complex project setup to be completed from a single conversation.\n\n---\n\n## Available Tools\n\nThe Astravue MCP Server provides **87 tools** across the following categories.\n\n

Spaces (5 tools)

\n\n

Projects (6 tools)

\n\n

Tasks (13 tools)

\n\n

Subtasks (4 tools)

\n\n

Comments (4 tools)

\n\n

Checklists (4 tools)

\n\n

Dependencies (3 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_add_dependency` | Links two tasks with a blocking relationship | \"Database schema must complete before API implementation\" |\n| `astravue_list_dependencies` | Shows all dependencies for a task | \"What does the API implementation task depend on?\" |\n| `astravue_remove_dependency` | Removes a dependency link | \"Remove the dependency between design and implementation\" |\n\n

\n\n

Tags (3 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_list_tags` | Lists all tags available in your organization | \"What tags do we have?\" |\n| `astravue_add_tag_to_task` | Adds an existing tag to a task | \"Tag the login task as 'urgent'\" |\n| `astravue_remove_tag_from_task` | Removes a tag from a task | \"Remove the 'blocked' tag from the deployment task\" |\n\n

\n\n

Attachments (2 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_list_attachments` | Lists all attachments on a task | \"What files are attached to the design task?\" |\n| `astravue_delete_attachment` | Deletes an attachment from a task | \"Remove the old mockup file from the design task\" |\n\n

\n\n

Time Tracking (10 tools)

\n\n

Custom Fields (7 tools)

\n\n

Task Statuses (5 tools)

\n\n

Filters (4 tools)

\n\n

Scheduled & Overdue Tasks (2 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_list_overdue_tasks` | Lists overdue tasks assigned to the current user | \"Show me everything overdue\" |\n| `astravue_list_scheduled_tasks` | Lists upcoming tasks with due dates | \"What tasks are due this week?\" |\n\n

\n\n

Notifications (2 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_list_notifications` | Lists unread notifications | \"What notifications do I have?\" |\n| `astravue_mark_notification_read` | Marks notifications as read | \"Mark all my notifications as read\" |\n\n

\n\n

Workspace & Members (3 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_get_workspace_members` | Lists workspace members | \"Who are the members of my workspace?\" |\n| `astravue_get_member_by_email` | Finds a member by email | \"Find the profile for sarah@company.com\" |\n| `astravue_get_current_user` | Returns the authenticated user's profile | \"Who am I logged in as?\" |\n\n

\n\n

Interactive Views (3 tools)

\n\n| Tool | Description | Example Prompt |\n| :--- | :---------- | :------------- |\n| `astravue_preview_task_list` | Opens an interactive task list view for a project | \"Show me the task board for Sprint 2\" |\n| `astravue_preview_my_tasks` | Opens a view of all tasks assigned to the current user | \"Show me my tasks\" |\n| `astravue_preview_project_overview` | Opens a project overview with completion, health, and attention items | \"Give me an overview of the Backend project\" |\n\n

\n\n---\n\n## Available Prompts\n\nThe Astravue MCP Server provides **15 prompts** — pre-built workflows that guide your AI assistant through common project management tasks.\n\n| Prompt | Description | Arguments |\n| :----- | :---------- | :-------- |\n| `daily_standup` | Generate a structured daily standup update for the current user based on their tasks | — |\n| `project_status_report` | Generate a professional project status report tailored for executive, stakeholder, or team audience | — |\n| `weekly_team_digest` | Generate a weekly digest summarising what shipped, what is at risk, and what is coming up | — |\n| `task_breakdown` | Suggest a subtask decomposition for a complex task to make it actionable | — |\n| `overdue_action_plan` | Generate a prioritised recovery plan for the current user's overdue tasks | — |\n| `sprint_planner` | Plan a sprint: select tasks by priority, estimate workload, assign owners, and define the sprint goal | `sprintGoal` (required) |\n| `risk_assessment` | Identify at-risk projects and tasks: overdue items, off-track projects, unassigned high-priority work, and deadline conflicts | — |\n| `time_tracking_report` | Generate a time tracking and effort summary for the current user across tasks | — |\n| `meeting_agenda_generator` | Generate a structured meeting agenda based on current tasks, blockers, and project status | `meetingType` (optional): `standup`, `sprint_review`, `planning`, `retrospective`, `stakeholder_update` |\n| `retrospective_summary` | Generate a sprint or project retrospective: what went well, what did not, and action items | — |\n| `capacity_planning` | Analyse current team workload: identify who is overloaded, who has bandwidth, and suggest task redistribution | — |\n| `project_kickoff` | Generate a project kickoff checklist with role assignments, initial tasks, and success criteria | — |\n| `blockers_escalation` | Identify critical blockers and draft escalation messages for items requiring management attention | — |\n| `milestone_review` | Review progress toward project milestones: completed work, at-risk items, and recommended adjustments | — |\n| `team_workload_balancer` | Show each team member's task load and suggest reassignments to balance workload evenly | — |\n\n---\n\n## Available Resources\n\nThe Astravue MCP Server provides **6 resources** — context data that AI assistants can attach to conversations for richer, more accurate responses.\n\n### Static Resources\n\n| Resource URI | Name | Description |\n| :----------- | :--- | :---------- |\n| `astravue://user/me` | Current User Profile | The authenticated user's profile: ID, name, email, and organisation role. Read at session start to establish user context before assigning tasks or personalising any response. |\n| `astravue://org/members` | Organisation Members | All active members of the organisation with user IDs, names, emails, and roles. Use to resolve teammate names to numeric IDs before any task assignment operation. |\n| `astravue://org/spaces` | Organisation Spaces | All spaces the current user is a member of. Use to discover space IDs before calling project or task tools. |\n| `astravue://dashboard/overview` | Dashboard Overview | Current user's task count summary: total, pending, completed, and overdue. Use for a quick org health snapshot. |\n\n### Resource Templates\n\n| Template URI | Name | Description |\n| :----------- | :--- | :---------- |\n| `astravue://spaces/{spaceId}/projects` | Projects in Space | All projects within a given space. Replace `{spaceId}` with the numeric space ID. |\n| `astravue://spaces/{spaceId}/projects/{projectId}/overview` | Project Overview | Full details of a specific project. Replace `{spaceId}` and `{projectId}` with numeric IDs. |\n\n\n---\n\n## Skills\n\nThis repository includes ready-to-use skills that automate common project management workflows:\n\n| Skill | Description |\n| :---- | :---------- |\n| [Sprint Planning](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/sprint-planning/SKILL.md) | Analyzes backlog, overdue tasks, and dependencies to build a prioritized sprint plan |\n| [Status Report](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/generating-status-report/SKILL.md) | Generates executive project status reports covering progress, budget, and risks |\n| [Time Tracking](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/tracking-time/SKILL.md) | Guides timer usage, manual time logging, and timesheet report generation |\n| [Custom Fields](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/managing-custom-fields/SKILL.md) | Creates, configures, and manages custom fields and dropdown options |\n| [Breaking Down Work](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/breaking-down-work/SKILL.md) | Decomposes a goal, feature, or epic into a structured task tree with dependencies |\n| [Capturing Meeting Actions](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/capturing-meeting-actions/SKILL.md) | Extracts action items from meeting notes or transcripts and creates owned, dated tasks |\n| [Mapping Dependencies](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/mapping-dependencies/SKILL.md) | Maps task dependencies, finds the critical path, and detects circular dependencies |\n| [Triaging Overdue Work](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/skills/triaging-overdue-work/SKILL.md) | Reviews overdue and at-risk tasks and proposes reschedule, reassign, or close actions |\n\nSkills are available automatically when using the Claude Code or Cursor plugin.\n\n---\n\n## Data and Security\n\n* All traffic is encrypted via HTTPS using TLS 1.2 or later.\n* OAuth 2.0 authentication ensures secure access control.\n* Data access respects your workspace role and project-level permissions.\n* The MCP server never stores credentials — authentication is handled per session.\n\nFor more details, see [SECURITY.md](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/SECURITY.md).\n\n---\n\n## Rate Limits\n\nAstravue MCP enforces rate limits to ensure platform stability.\n\n| | |\n| :--- | :--- |\n| **Requests per user per minute** | 100 |\n| **Bulk task create limit** | 100 tasks per call |\n\nIf the limit is exceeded, the server returns `HTTP 429 Too Many Requests`. Wait 60 seconds before retrying.\n\n---\n\n## Troubleshooting\n\n

Authentication fails or browser does not open

\n\nSign out of Astravue at [app.astravue.com](https://app.astravue.com), sign back in, then reconnect your AI client.\n\n

\n\n

401 Unauthorized error

\n\nYour OAuth session expired. Reconnect your client to trigger a new sign-in flow.\n\n

\n\n

Tools not appearing in my AI client

\n\nEnsure your client supports **Streamable HTTP transport**. Clients that only support SSE must use the `mcp-remote` bridge (see [Other MCP Clients](#other-mcp-clients)).\n\n

\n\n

Connection drops after some time

\n\nOAuth tokens expire periodically. Your client should refresh automatically. If it does not, reconnect once.\n\n

\n\n---\n\n## FAQ\n\n

Do I need a paid Astravue plan?

\n\nNo. Astravue MCP works on all plans including free.\n\n

\n\n

Can multiple team members connect their AI clients?

\n\nYes. Each user authenticates with their own Astravue account.\n\n

\n\n

What permissions does Astravue MCP have?

\n\nAstravue MCP only has access to resources your account already has permission to access. All actions are performed as your authenticated user.\n\n

\n\n

Can I use an API key instead of OAuth?

\n\nNo. OAuth 2.0 is required so every action is tied to an authenticated user.\n\n

\n\n

Will the AI make changes without asking me?

\n\nMost AI clients ask for confirmation before executing write operations. Check your client's tool approval settings.\n\n

\n\n---\n\n## Contributing\n\nWe welcome contributions. See [CONTRIBUTING.md](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/CONTRIBUTING.md) for guidelines.\n\n## Code of Conduct\n\nThis project follows the [Contributor Covenant](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/CODE_OF_CONDUCT.md).\n\n## License\n\nThis project is licensed under the [Apache License 2.0](https://github.com/AstravueOrg/astravue-mcp-server/blob/main/LICENSE).\n\nCopyright 2026 Astravue.\n\n---\n\n## Support\n\n* Open an issue on [GitHub](https://github.com/AstravueOrg/astravue-mcp-server/issues)\n* Email [support@astravue.com](mailto:support@astravue.com)\n* Visit [help.astravue.com](https://help.astravue.com)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":98,"_99":-5,"_100":101,"_102":103},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[104,105,106,107,108,109,110,111,112,113],"license","Apache-2.0","language","registryName","com.astravue/astravue-mcp","homepage","https://astravue.com/mcp-server","ai-tools","anthropic-claude","astravue","cline-ai","cursor","mcp","model-context-protocol","project-management","vscode","windsurf-ai","ENV",{"_116":117,"_118":119,"_120":121},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]