Back to Browse

Vaiz MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Connect AI assistants to your Vaiz workspace: tasks, projects, boards, documents and milestones.

About

Connect AI assistants to your Vaiz workspace: tasks, projects, boards, documents and milestones.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

7 files analyzed ยท 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Vaiz API key (Bearer token)Required

Environment variable: VAIZ_API_TOKEN

Your Vaiz Space IDOptional

Environment variable: VAIZ_SPACE_ID

Vaiz MCP API URL (default: https://api.vaiz.com/mcp)Optional

Environment variable: VAIZ_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-vaiz-mcp": {
      "env": {
        "VAIZ_API_URL": "your-vaiz-api-url-here",
        "VAIZ_SPACE_ID": "your-vaiz-space-id-here",
        "VAIZ_API_TOKEN": "your-vaiz-api-token-here"
      },
      "args": [
        "-y",
        "vaiz-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

vaiz-mcp

smithery badge

MCP (Model Context Protocol) client for Vaiz โ€” connect Cursor/Claude to your Vaiz workspace.

Installation

npm install -g vaiz-mcp

Or use directly via npx:

npx vaiz-mcp

Configuration

Environment Variables

VariableRequiredDescription
VAIZ_API_TOKENYesYour Vaiz API key (Bearer token)
VAIZ_SPACE_IDNoYour Vaiz Space ID
VAIZ_API_URLNoMCP API URL (default: https://api.vaiz.com/mcp)
VAIZ_DEBUGNoSet to true for debug output to stderr

Cursor Configuration

Create or edit ~/.cursor/mcp.json:

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

Or after global installation (npm install -g vaiz-mcp):

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

Claude Desktop Configuration

Add to claude_desktop_config.json:

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

Usage

After configuration, Cursor/Claude will automatically connect to your Vaiz workspace and gain access to:

  • ๐Ÿ” Search tasks, projects, users
  • ๐Ÿ“‹ Task management (create, edit, comments)
  • ๐Ÿ“Š View boards and projects
  • ๐Ÿ‘ฅ Team member information
  • ๐Ÿ“ Work with documents and milestones

Debugging

To enable debug output, add the VAIZ_DEBUG variable:

{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp@latest"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_DEBUG": "true"
      }
    }
  }
}

Debug messages will be output to stderr.

Programmatic Usage

You can also use the library programmatically:

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' 
});

Development

# Clone the repository
git clone https://github.com/vaiz/vaiz-mcp.git
cd vaiz-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Platforms

LobeHub

License

MIT

Reviews

No reviews yet

Be the first to review this server!

Vaiz MCP Server - Connect AI assistants to your Vaiz workspace: tasks, | MCP Marketplace