Get started

Connect your AI client to Astravue MCP and start managing projects, tasks, and teams directly from natural language conversations.

INFO

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.

Claude

Connectors Directory

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

Open Connectors

In Claude.ai or Claude Desktop, go to Customize → Connectors.

Find Astravue

Click +, browse the Connectors Directory, and search for Astravue.

Connect

Select Astravue, click Connect, then sign in to Astravue and approve access.

Use it in a chat

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: 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 the GitHub 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.

Option B: MCP server only

Add Astravue MCP

Run the following command in your terminal:

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.

Confirm the connection

In a new Claude Code session, run:

/mcp

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

Open Connectors

Go to Customize → Connectors in Claude Desktop.

Find Astravue

Click +, browse the directory, and search for Astravue.

Connect

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

Example configuration:

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

Save the file and restart Claude Desktop.

Claude.ai on the web

Open Connectors

Go to claude.ai → Customize → Connectors.

Find Astravue

Click +, browse the directory, and search for Astravue.

Connect

Select Astravue, click Connect, then sign in and approve access.

Claude for iOS and 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.

Code editors and CLIs

Cursor

Open MCP settings

Go to Cursor Settings → Tools & MCP

Add Astravue MCP

Click New MCP Server — this opens your mcp.json file

Add the following:

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

Save the file.

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

Project-level configuration (.cursor/mcp.json)

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

Create config file

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

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

Start the server

Open Command Palette:

Cmd + Shift + P (macOS)
Ctrl + Shift + P (Windows)

Run:

MCP: List Servers

Click Start next to astravue-mcp.

Authenticate with your Astravue account in the browser.

User-level configuration (all projects)

Add this to User Settings (JSON).

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

Windsurf

Open MCP settings

Open the Windsurf MCP config file:

macOS / Linux

~/.codeium/mcp_config.json

Windows

C:\Users\[username]\.codeium\mcp_config.json

Or go to New MCP plugins can be added by going to the Settings > Tools > Windsurf Settings > Add Server section.

If you cannot find your desired MCP plugin, you can add it manually by clicking View Raw Config button and editing the raw mcp_config.json file.

When you click on an MCP server, simply click + Add Server to expose the server and its tools to Cascade.

Add Astravue

Add the following to your config file:.

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

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

Reload Windsurf and authenticate with your Astravue account.

Cline

Open MCP Servers

Click the Cline icon in the VS Code sidebar → Click the menu (⋮) in the top right → Select MCP Servers.

Add Astravue MCP

Go to the Remote Servers tab and fill in:

Server Name: astravue-mcp

Server URL: https://api.astravue.com/mcp

Transport Type: Streamable HTTP

Click Add Server.

Your browser will open for OAuth authentication.
Sign in with your Astravue account and click Approve.

Manual JSON configuration (cline_mcp_settings.json)

Click Configure MCP Servers in the Configure tab to open the JSON file and add:

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

JetBrains IDEs

Open MCP settings

Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)

Add Astravue MCP

Click Add → Select Streamable HTTP → Paste the following:

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

Click OK, then Apply.

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

Codex

INFO

Works in the Codex CLI, the Codex IDE extension, and the ChatGPT desktop app — they share ~/.codex/config.toml.

Add Astravue MCP

Run:

codex mcp add astravue-mcp --url https://api.astravue.com/mcp

Run:

codex mcp login astravue-mcp

Your browser opens. Sign in with your Astravue account and click Approve.

Confirm the connection

Run /mcp in Codex to confirm astravue-mcp is connected.

Configure in config.toml instead

Add this to ~/.codex/config.toml, or to .codex/config.toml in a trusted project to scope it to that project:

[mcp_servers.astravue-mcp]
url = "https://api.astravue.com/mcp"

Then run codex mcp login astravue-mcp.

GitHub Copilot CLI

Run:

copilot mcp add --transport http astravue-mcp https://api.astravue.com/mcp

Manual JSON configuration

Add this to ~/.copilot/mcp-config.json:

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

Gemini CLI

Install the Astravue extension

Run:

gemini extensions install https://github.com/AstravueOrg/astravue-mcp-server

Start Gemini CLI and run:

/mcp auth astravue

Your browser opens. Sign in with your Astravue account and click Approve.

Manual configuration (settings.json)

Add this to ~/.gemini/settings.json, then run /mcp auth astravue-mcp:

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

Chat apps

ChatGPT

INFO

Custom MCP servers are available on ChatGPT Business and Enterprise/Edu, on chatgpt.com. Workspace admins and owners create the app and publish it to the workspace.

Add a custom MCP server

Go to Plugins, select +, then Add custom MCP server.

Enter the connection details

Name: Astravue

Connection: https://api.astravue.com/mcp

Authentication: OAuth

Select I understand and want to continue, then Create as a plugin.

Use Astravue in a chat

In a chat, select Astravue for the message, or @mention it.

ChatGPT desktop app

Open Settings → MCP servers → Add server, enter the name astravue-mcp, choose Streamable HTTP, and enter https://api.astravue.com/mcp. Restart, then select Authenticate and sign in to Astravue.

Perplexity

Add a custom connector

Open Plugins in the sidebar and select Add custom.

Enter the connection details

Name: Astravue

MCP server URL: https://api.astravue.com/mcp

Under Advanced settings, choose OAuth, select the acknowledgement checkbox, and click Add.

Use Astravue in a chat

Ask Perplexity something Astravue can do, for example "show my open tasks".

In an organization, an administrator must first turn on Allow members to add custom connectors.

Connected, but no tools are listed

Perplexity does not always list the tools of a custom connector. The connection still works — ask for Astravue actions directly in chat, such as "list my Astravue spaces".

Mistral Le Chat

Coming soon.

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:

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

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

Try it

Once connected, try asking your AI assistant:

Create a project called Sprint Planning in the Engineering space

Show me all overdue tasks

Assign the login bug to Sarah and set it to high priority

Start tracking time on the API documentation task

Troubleshooting

Authentication fails or browser does not open

Sign out of Astravue at app.astravue.com, sign back in, then reconnect your AI client.

Client not found or Unknown server error

Remove the Astravue connection from your client and add it again.

401 Unauthorized error

Your OAuth session expired. Reconnect your client to trigger a new sign-in flow.

Tools not appearing in my AI client

Ensure your client supports Streamable HTTP transport.
Clients that only support SSE must use the mcp-remote bridge.

Connection drops after some time

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

FAQ

Do I need a paid Astravue plan?

No. Astravue MCP works on all plans including free.

Can multiple team members connect their AI clients?

Yes. Each user authenticates with their own Astravue account.

What permissions does Astravue MCP have?

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

Can I use an API key instead of OAuth?

No. OAuth 2.0 is required so every action is tied to an authenticated user.

Will the AI make changes without asking me?

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

Claude#

Connectors Directory#

Claude Code#

Option A: plugin#

Option B: MCP server only#

Claude Desktop#

Claude.ai on the web#

Claude for iOS and Android#

Code editors and CLIs#

Cursor#

VS Code#

Windsurf#

Cline#

JetBrains IDEs#

Codex#

GitHub Copilot CLI#

Gemini CLI#

Chat apps#

ChatGPT#

Perplexity#

Mistral Le Chat#

Other MCP clients#

Try it#

Troubleshooting#

FAQ#

Claude

Connectors Directory

Claude Code

Option A: plugin

Option B: MCP server only

Claude Desktop

Claude.ai on the web

Claude for iOS and Android

Code editors and CLIs

Cursor

VS Code

Windsurf

Cline

JetBrains IDEs

Codex

GitHub Copilot CLI

Gemini CLI

Chat apps

ChatGPT

Perplexity

Mistral Le Chat

Other MCP clients

Try it

Troubleshooting

FAQ