Astravue MCP

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

Astravue is a verified and reviewed integration in the [Claude Connectors Directory](https://claude.ai/directory/astravue).

---

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.

---

Setup Instructions

Claude Connectors Directory (recommended)

Astravue is available as a verified connector across Claude.ai, Claude Desktop, Claude Mobile, Claude Code, and Cowork.

1. In Claude.ai or Claude Desktop, go to Customize → Connectors.
2. Click +, browse the Connectors Directory, and search for Astravue.
3. Select Astravue, click Connect, then sign in to Astravue and approve access.
4. Start a new conversation and enable Astravue from the + → Connectors menu.

When Claude Code is authenticated with your Claude.ai subscription, the connector is available automatically. Run /mcp to confirm it is connected. Claude Code sessions using an API key, Bedrock, or Vertex do not load Claude.ai connectors; use the direct connection command below instead.

---

Claude Code

The Connectors Directory provides the verified MCP connection. For eight guided project-management workflows as well, install the Astravue plugin. A direct MCP connection remains available for API-key, Bedrock, Vertex, and custom setups.

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:

/plugin marketplace add anthropics/claude-plugins-community

/plugin install astravue@claude-community /reload-plugins

Alternatively, install directly from this repository:

/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 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:

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:

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

1. Go to Customize → Connectors in Claude Desktop.
2. Click +, browse the directory, and search for Astravue.
3. Select Astravue, click Connect, then sign in and approve access.

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

{

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

Save the file and restart Claude Desktop.

---

Claude.ai (Web)

1. Go to claude.ai → Customize → Connectors.
2. Click +, browse the directory, and search for Astravue.
3. Select Astravue, click Connect, then sign in and approve access.

---

Claude Mobile (iOS / Android)

Claude Mobile uses the same connector ecosystem as Claude.ai. Connect Astravue from the mobile Connectors Directory, or connect it once on Claude.ai or Claude Desktop and use the same Claude account on mobile.

---

Cursor

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

{

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

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

{

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

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

User-level configuration (all projects)

Add this to your User Settings (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

1. Add the following:

{

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

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

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

{

"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 **Streama