# Astravue Mcp Server

> Official MCP server for Astravue — manage projects, tasks, time tracking, and teams through AI

- **Type:** MCP server
- **Install:** `agentstack add mcp-astravueorg-astravue-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [AstravueOrg](https://agentstack.voostack.com/s/astravueorg)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 1.0.1
- **License:** Apache-2.0
- **Upstream author:** [AstravueOrg](https://github.com/AstravueOrg)
- **Source:** https://github.com/AstravueOrg/astravue-mcp-server
- **Website:** https://astravue.com/mcp-server

## Install

```sh
agentstack add mcp-astravueorg-astravue-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Astravue MCP Server

  
    
  
  
  Click the image to download the full demo (with audio).

The 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.

With the Astravue MCP Server, you can:

* **Search and browse** spaces, projects, and tasks without switching tools.
* **Create and update** tasks, subtasks, checklists, and comments through natural language.
* **Track time** with live timers or manual entries and generate timesheet reports.
* **Manage custom fields** including dropdowns, dates, currencies, and more.
* **Automate workflows** like sprint planning, status reporting, and bulk task updates.

It's designed for project managers, developers, and teams who use AI-powered IDEs or assistants and want to manage work without context switching.

Full product documentation lives at **[docs.astravue.com](https://docs.astravue.com)**.

---

## Supported Clients

All clients connect to the same endpoint: `https://api.astravue.com/mcp`
You will be asked to sign in to Astravue in your browser the first time you connect.

| Client | Docs | Transport |
| :----- | :--- | :-------- |
| [Claude Code](#claude-code) | [MCP setup](https://code.claude.com/docs/en/mcp) | Streamable HTTP |
| [Claude Desktop](#claude-desktop) | [MCP setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) | Streamable HTTP |
| [Claude.ai (Web)](#claudeai-web) | [Remote MCP](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) | Streamable HTTP |
| [Claude Mobile](#claude-mobile-ios--android) | — | Streamable HTTP |
| [Cursor](#cursor) | [MCP setup](https://docs.cursor.com/context/model-context-protocol) | Streamable HTTP |
| [VS Code](#vs-code) | [MCP setup](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) | Streamable HTTP |
| [Windsurf](#windsurf) | [MCP setup](https://docs.windsurf.com/windsurf/cascade/mcp) | Streamable HTTP |
| [Cline](#cline) | [MCP setup](https://docs.cline.bot/mcp/configuring-mcp-servers) | Streamable HTTP |
| [JetBrains IDEs](#jetbrains-intellij-webstorm-pycharm-etc) | [MCP setup](https://www.jetbrains.com/help/ai-assistant/mcp.html) | Streamable HTTP |
| [Gemini CLI](#gemini-cli) | [MCP setup](https://geminicli.com/docs/tools/mcp-server/) | Streamable HTTP |

---

## Setup Instructions

### Claude Code

You have two installation options. **Option A** installs the full plugin (MCP server + eight productivity skills). **Option B** installs only the MCP server.

#### Option A — Install as a Claude Code plugin (recommended)

The 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.

Inside Claude Code, run:

```text
/plugin marketplace add anthropics/claude-plugins-community
/plugin install astravue@claude-community
/reload-plugins
```

Alternatively, install directly from this repository:

```text
/plugin marketplace add AstravueOrg/astravue-mcp-server
/plugin install astravue@astravue
/reload-plugins
```

After install, run `/mcp` to confirm **astravue** is connected, then open `/plugin` and switch to the **Installed** tab to view the bundled skills.

See Anthropic's [plugin discovery docs](https://code.claude.com/docs/en/discover-plugins) for installation scopes (user, project, local).

#### Option B — Install only the MCP server

If you only want the raw MCP server without the bundled skills, run:

```bash
claude mcp add --transport http astravue https://api.astravue.com/mcp
```

Your browser will open automatically. Sign in with your Astravue account and click **Approve**.

To confirm the connection, run `/mcp` in a new Claude Code session. You should see **astravue** listed with a green connected status.

Share connection across a project team

Add the `--scope project` flag to create a `.mcp.json` file in your project root:

```bash
claude mcp add --transport http --scope project astravue https://api.astravue.com/mcp
```

Commit `.mcp.json` to your repository so teammates automatically get the connection.

---

### Claude Desktop

> Requires a Claude Pro, Max, Team, or Enterprise plan.

1. Go to **Settings → Connectors** in Claude Desktop.
2. Click **Add custom connector** and enter: `https://api.astravue.com/mcp`
3. Sign in with your Astravue account in the browser and click **Approve**.

Manual config file setup (advanced)

If Connectors is not available in your Claude Desktop version, edit:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}
```

Save the file and restart Claude Desktop.

---

### Claude.ai (Web)

> Requires a Claude Pro, Max, Team, or Enterprise plan.

1. Go to [claude.ai](https://claude.ai) → **Settings → Connectors**
2. Click **Add connector** and enter: `https://api.astravue.com/mcp`
3. Sign in with your Astravue account in the browser and click **Approve**.

---

### Claude Mobile (iOS / Android)

Claude Mobile uses the same connector ecosystem as Claude.ai.

Add the connector on **Claude.ai (web)** or **Claude Desktop** first — it will automatically appear on your mobile app. No separate setup needed.

---

### Cursor

1. Go to **Cursor Settings → Tools & MCP**
2. Click **New MCP Server** — this opens your `mcp.json` file
3. Add the following configuration:

```json
{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}
```

4. Save the file. Your browser will open — sign in with your Astravue account and click **Approve**.

Project-level configuration

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

---

### VS Code

1. Add a `.vscode/mcp.json` file to your project root:

```json
{
  "servers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}
```

2. Open Command Palette (`Cmd+Shift+P` on macOS, `Ctrl+Shift+P` on Windows), run **MCP: List Servers**, and click **Start** next to `astravue-mcp`.
3. Authenticate with your Astravue account in the browser.

User-level configuration (all projects)

Add this to your **User Settings (JSON)**:

```json
{
  "mcp": {
    "servers": {
      "astravue-mcp": {
        "type": "http",
        "url": "https://api.astravue.com/mcp"
      }
    }
  }
}
```

---

### Windsurf

1. Open the Windsurf MCP config file:
   * **macOS / Linux:** `~/.codeium/mcp_config.json`
   * **Windows:** `C:\Users\[username]\.codeium\mcp_config.json`
   * Or go to **Settings → Tools → Windsurf Settings → Add Server**

2. Add the following:

```json
{
  "mcpServers": {
    "astravue-mcp": {
      "serverUrl": "https://api.astravue.com/mcp"
    }
  }
}
```

> 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.

3. Reload Windsurf and authenticate with your Astravue account.

---

### Cline

1. Click the **Cline icon** in the VS Code sidebar → click the **menu (⋮)** in the top right → select **MCP Servers**.
2. Go to the **Remote Servers** tab and fill in:
   * **Server Name:** `astravue-mcp`
   * **Server URL:** `https://api.astravue.com/mcp`
   * **Transport Type:** `Streamable HTTP`
3. Click **Add Server**. Your browser will open — sign in and click **Approve**.

Manual JSON configuration

Click **Configure MCP Servers** in the Configure tab to open `cline_mcp_settings.json` and add:

```json
{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp",
      "type": "streamableHttp"
    }
  }
}
```

---

### JetBrains (IntelliJ, WebStorm, PyCharm, etc.)

1. Go to **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**
2. Click **Add** → Select **Streamable HTTP** → Paste:

```json
{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}
```

3. Click **OK**, then **Apply**. Sign in with your Astravue account in the browser.

---

### Gemini CLI

Copy `gemini-extension.json` from this repository to your Gemini CLI extensions directory, or add the server URL to your Gemini MCP configuration.

---

### Other MCP Clients

For any client that supports **Streamable HTTP + OAuth 2.0**:

| Setting | Value |
| :------ | :---- |
| Server URL | `https://api.astravue.com/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth 2.0 (Authorization Code + PKCE) |

SSE-only clients (mcp-remote bridge)

If your client only supports SSE transport, run:

```bash
npx -y mcp-remote@latest https://api.astravue.com/mcp
```

Point your client to the local mcp-remote process instead of the Astravue URL.

---

## How It Works

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.

> **Authentication:** All tools require an active authenticated session. If a tool call fails with `401 Unauthorized`, reconnect your AI client to refresh your session.

> **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.

---

## 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

| Role | MCP Access |
| :--- | :--------- |
| **Account Admin** | Full access to all spaces, projects, and tasks across the organization |
| **Admin** | Full access to all spaces, projects, and tasks across the organization |
| **Manager** | Can manage spaces and projects they are a member of |
| **Member** | Can read and write within spaces and projects they belong to |
| **Guest** | Read-only. Cannot perform any write operations through MCP |

### Space-Level Permissions

| Action | Required Role |
| :----- | :------------ |
| List spaces, view space details | Space Member |
| Create, update, delete a space | Org Admin or Manager |

### Project-Level Permissions

| Action | Required Role |
| :----- | :------------ |
| List tasks, view project details | Project Member |
| Create or update tasks | Project Member |
| Add project members, delete project | Project Admin |
| Manage custom fields, statuses | Project Admin |

### Task-Level Permissions

| Action | Required Role |
| :----- | :------------ |
| View tasks, comments, checklists | Project Member |
| Create tasks, add comments, log time | Project Member |
| Delete a task | Task Owner, Task Creator, or Project Admin |
| Delete a comment | Comment Creator or Org Admin |

> 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` — creates the Sprint 5 project
2. `astravue_bulk_create_tasks` — creates the three tasks in one call
3. `astravue_update_task` — sets priorities or due dates as needed

This allows complex project setup to be completed from a single conversation.

---

## Available Tools

The Astravue MCP Server provides **87 tools** across the following categories.

Spaces (5 tools)

| Tool | Description | Example Prompt |
| :--- | :---------- | :------------- |
| `astravue_list_spaces` | Lists all spaces in your organization | "Show me all my spaces" |
| `astravue_get_space` | Gets details of a specific space including its projects | "What projects are in the Design space?" |
| `astravue_create_space` | Creates a new space | "Create a space called Product Development" |
| `astravue_update_space` | Updates a space name or settings | "Rename the Marketing space to Growth" |
| `astravue_delete_space` | Permanently deletes a space and all its contents | "Delete the archived Test space" |

Projects (6 tools)

| Tool | Description | Example Prompt |
| :--- | :---------- | :------------- |
| `astravue_list_projects` | Lists all projects within a space | "List all projects in the Engineering space" |
| `astravue_get_project` | Gets full details of a specific project | "What's the current status of Sprint 3?" |
| `astravue_create_project` | Creates a new project inside a space | "Create a project called Q2 Roadmap in the Product space" |
| `astravue_update_project` | Updates a project's name, status, priority, or health | "Mark Sprint 1 as completed" |
| `astravue_delete_project` | Permanently deletes a project and all its tasks | "Delete the duplicate Onboarding project" |
| `astravue_add_project_member` | Adds an existing workspace member to a project | "Add john@company.com to the Backend project" |

Tasks (13 tools)

| Tool | Description | Example Prompt |
| :--- | :---------- | :------------- |
| `astravue_list_project_tasks` | Lists all tasks within a project | "Show all open tasks in Sprint 2" |
| `astravue_get_task` | Gets full task details | "What's the status of the login bug task?" |
| `astravue_find_tasks` | Searches tasks by keyword across all projects | "Find all tasks related to payments" |
| `astravue_create_task` | Creates a task in a project | "Create a high priority task: Fix authentication bug" |
| `astravue_update_task` | Updates task fields | "Assign the API docs task to Sarah" |
| `astravue_delete_task` | Deletes a task | "Delete the duplicate checkout task" |
| `astravue_move_task` | Moves a task from one project to another | "Move the login task from Sprint 1 to Sprint 2" |
| `astravue_duplicate_task` | Creates a copy of an existing task | "Duplicate the API integration task with all subtasks" |
| `astravue_create_personal_task` | Creates a personal task not tied to any project | "Remind me to review the design doc by Friday" |
| `astravue_bulk_create_tasks` | Creates multiple tasks in one call | "Create these 10 sprint tasks with owners and priorities" |
| `astravue_bulk_update_tasks` | Updates multiple tasks at once | "Set all 5 sprint tasks to In-Progress" |
| `astravue_bulk_delete_tasks` | Deletes multiple tasks at once | "Delete all the duplicate tasks from Sprint 1" |
| `astravue_get_task_counts` | Returns task count summary: total, pending, completed, overdue | "How many tasks are open vs completed?" |

Subtasks (4 tools)

| Tool | Description | Example Prompt |
| :--- | :---------- | :------------- |
| `astravue_list_subtasks` | Lists subtasks under a parent task | "Show the subtasks of the authentication feature" |
| `astravue_create_subtask` | Creates a new subtask | "Add a subtask: Write unit tests under the API task" |
| `astravue_update_subtask` | Updates a subtask's title, status, or priority | "Mark the unit tests subtask as done" |
| `astravue_delete_subtask` | Deletes a subtask | "Delete the duplicate subtask under the API task" |

Comments (4 tools)

| Tool | Description | Example Prompt |
| :--- | :---------- | :------------- |
| `astravue_get_task_comments` | Lists comments on a

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [AstravueOrg](https://github.com/AstravueOrg)
- **Source:** [AstravueOrg/astravue-mcp-server](https://github.com/AstravueOrg/astravue-mcp-server)
- **License:** Apache-2.0
- **Homepage:** https://astravue.com/mcp-server

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-astravueorg-astravue-mcp-server
- Seller: https://agentstack.voostack.com/s/astravueorg
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.