Vaiz MCP
The Vaiz MCP server connects AI tools like Cursor/Claude to your Vaiz workspace, enabling AI-powered project management through the following capabilities:
Search Search for tasks, projects, users, comments, boards, and documents within your workspace.
Task Management
Get tasks with filtering by board, project, assignees, priority, milestone, type, status, and creator
Get a specific task by database ID or HRID (e.g.,
PRJ-123)Create tasks with name, board, assignees, priority, due dates, description (Markdown), milestones, and more
Edit tasks (name, priority, assignees, due dates, completion status, etc.)
View and create task comments (with reply support)
View task history (change log with filtering by date, user, and field)
Set task blockers (blocking/blocked-by relationships)
Project & Board Management
List all projects and get project details or activity history
List all boards (optionally filtered by project) and get board details
Get board automations (workflows configured for a board)
Document Management
Get document details, comments, and history
Edit document content (append or replace using Markdown)
Milestone Management
List milestones (filtered by board or project), get milestone details, and create new milestones
Workspace & Team
List available spaces, get current space info and user permissions, and switch spaces
Get current user info, list all workspace members, and get member details or activity history
Notifications & Resources
Get notifications with filtering by group, read status, and pinned state
List and read MCP resources (dictionaries, knowledge base articles, workspace data)
Ping the server for connectivity testing
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vaiz MCPshow me my open tasks for this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
vaiz-mcp
MCP (Model Context Protocol) client for Vaiz β connect Cursor/Claude to your Vaiz workspace.
Installation
npm install -g vaiz-mcpOr use directly via npx:
npx vaiz-mcpRelated MCP server: Claude Code MCP for Cursor
Configuration
Environment Variables
Variable | Required | Description |
| Yes | Your Vaiz API key (Bearer token) |
| No | Your Vaiz Space ID |
| No | MCP API URL (default: |
| No | Set to |
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 devPlatforms
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables natural language management of ClickUp workspaces, including task CRUD operations, task listing, and user profile retrieval via Claude Desktop.Last updated61MIT
- AlicenseBqualityCmaintenanceBridges Claude Code CLI with Cursor IDE to use your existing Claude subscription without separate API costs.Last updated13MIT
- Flicense-qualityDmaintenanceConnects Claude to Jira, allowing users to query tasks, log work, add comments, and execute JQL queries through conversational AI.Last updated
- Alicense-qualityDmaintenanceConnects AI agents in Cursor to an Odoo instance, enabling natural language management of projects, epics, tasks, and milestones with tags and priorities.Last updatedMIT
Related MCP Connectors
Connect your team's living knowledge base β docs, data, issues, CRM β to Claude and ChatGPT.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analyβ¦
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/vaizcom/vaiz-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server