Vaiz

You can connect Vaiz MCP to Cursor or Claude to access tasks, projects, and team workspaces directly from your development environment. This MCP client lets you query and manipulate your Vaiz workspace through familiar tools, giving you fast access to search, task management, boards, and documents.

How to use

Once you have configured your MCP client, Cursor or Claude will connect to your Vaiz workspace automatically. You can perform practical actions such as searching across tasks, projects, and users; creating and editing tasks; leaving comments; viewing boards and project structures; and managing documents and milestones. Use the available MCP features to streamline your daily workflow and stay synchronized with your Vaiz workspace.

How to install

Prerequisites: You need Node.js and npm installed on your system.

Install the MCP client globally so you can run it from any shell.

npm install -g vaiz-mcp

# Or run directly without installation
npx vaiz-mcp

Configuration and usage notes

Configure the MCP client with your Vaiz credentials and workspace. You can connect via a local Cursor/Claude setup or use direct command invocations.

# Cursor configuration (user home)
{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

# After global installation
{
  "mcpServers": {
    "vaiz": {
      "command": "vaiz-mcp",
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

# Claude Desktop
{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

To enable debugging output, set the VAIZ_DEBUG environment variable to true. See the Debugging section for details.

## Programmatic usage

If you prefer to integrate the MCP client directly in your code, you can import and use the library programmatically. The following illustrates how to create a client, initialize the connection, list available tools, and call a tool.

import { createVaizMCPClient } from 'vaiz-mcp';

const client = createVaizMCPClient({ apiKey: 'your-api-key', spaceId: 'your-space-id', });

// Initialize connection const initResult = await client.initialize();

// Get list of tools const tools = await client.listTools();

// Call a tool const result = await client.callTool('search', { query: 'important task', entityType: 'task' });

## Debugging and troubleshooting

If you need verbose output for troubleshooting, enable the debug flag in your environment. Debug messages are written to standard error, making it easy to capture logs in your development environment.

{ "mcpServers": { "vaiz": { "command": "vaiz-mcp", "env": { "VAIZ_API_TOKEN": "your-api-key", "VAIZ_SPACE_ID": "your-space-id", "VAIZ_DEBUG": "true" } } } }

## Development and notes

The MCP client is designed to provide a seamless bridge between your Vaiz workspace and MCP-enabled clients. You can use either the npx-based execution path or the globally installed vaiz-mcp command depending on your workflow.

## Available tools

### initialize

Initialize the MCP client and establish a connection to Vaiz.

### listTools

Retrieve the list of available MCP tools exposed by Vaiz.

### callTool

Invoke a specific tool by name with the required parameters.