Supports automated release processes including creating GitHub tags and releases, generating release notes from commits, and managing version releases through GitHub's platform.
Enables automated publishing to NPM registry as part of the release process, with support for version management and package distribution.
BusinessMap MCP Server
Model Context Protocol server for BusinessMap (Kanbanize) integration. Provides comprehensive access to BusinessMap's project management features including workspaces, boards, cards, subtasks, parent-child relationships, outcomes, custom fields, and more.
Installation
Via NPX (Recommended)
You can run the BusinessMap MCP server directly using npx without installing it globally:
Global Installation
Configuration
Environment Variables
The server requires the following environment variables:
BUSINESSMAP_API_TOKEN
: Your BusinessMap API tokenBUSINESSMAP_API_URL
: Your BusinessMap API URL (e.g.,https://your-account.kanbanize.com/api/v2
)BUSINESSMAP_READ_ONLY_MODE
: Set to"true"
for read-only mode,"false"
to allow modifications (optional, defaults to"false"
)BUSINESSMAP_DEFAULT_WORKSPACE_ID
: Set the BusinessMap workspace ID (optional)
Claude Desktop
Add the following configuration to your claude_desktop_config.json
file:
Cursor
To use the BusinessMap MCP server with Cursor, add the following configuration to your Cursor settings:
Open Cursor Settings (Cmd/Ctrl + ,)
Click on "MCP & Integrations" and then "Add Custom MCP"
Add a new MCP server with the following configuration:
VSCode
To use the BusinessMap MCP server with VSCode, add the following configuration:
Edit or create
.vscode/mcp.json
and add the MCP extension settings:
Other MCP Clients
For other MCP clients, use the appropriate configuration format for your client, ensuring you specify:
Command:
npx @edicarlos.lds/businessmap-mcp
(orbusinessmap-mcp
if globally installed)Environment variables:
BUSINESSMAP_API_TOKEN
,BUSINESSMAP_API_URL
, and optionallyBUSINESSMAP_READ_ONLY_MODE
,BUSINESSMAP_DEFAULT_WORKSPACE_ID
Manual Setup
Clone this repository:
git clone https://github.com/edicarloslds/businessmap-mcp.git cd businessmap-mcpInstall dependencies:
npm installCreate a
.env
file with your BusinessMap credentials (for development/testing):BUSINESSMAP_API_TOKEN=your_token_here BUSINESSMAP_API_URL=https://your-account.kanbanize.com/api/v2 BUSINESSMAP_READ_ONLY_MODE=false BUSINESSMAP_DEFAULT_WORKSPACE_ID=1Note: When using as an MCP server with Claude Desktop, you don't need a
.env
file. Configure the environment variables directly in your MCP client configuration instead.Build the project:
npm run buildStart the server:
npm start
Usage
The BusinessMap MCP server provides the following tools:
Workspace Management
list_workspaces
- Get all workspacesget_workspace
- Get workspace detailscreate_workspace
- Create new workspace
Board Management
list_boards
- List boards in workspace(s)search_board
- Search for boards by ID or nameget_current_board_structure
- Get the complete current structure of a board including workflows, columns, lanes, and configurationscreate_board
- Create new board (if not in read-only mode)get_columns
- Get all columns for a boardget_lanes
- Get all lanes for a boardget_lane
- Get details of a specific lane/swimlanecreate_lane
- Create new lane/swimlane (if not in read-only mode)
Card Management
Basic Card Operations
list_cards
- Get cards from a board with optional filtersget_card
- Get detailed card informationget_card_size
- Get the size/points of a specific cardcreate_card
- Create new cardmove_card
- Move card to different column/swimlaneupdate_card
- Update card propertiesset_card_size
- Set the size/points of a specific card
Card Comments
get_card_comments
- Get all comments for a specific cardget_card_comment
- Get details of a specific comment from a card
Card Custom Fields & Types
get_card_custom_fields
- Get all custom fields for a specific cardget_card_types
- Get all available card types
Card Outcomes & History
get_card_outcomes
- Get all outcomes for a specific cardget_card_history
- Get the history of a specific card outcome
Card Relationships
get_card_linked_cards
- Get all linked cards for a specific card
Card Subtasks
get_card_subtasks
- Get all subtasks for a specific cardget_card_subtask
- Get details of a specific subtask from a cardcreate_card_subtask
- Create a new subtask for a card
Card Parent Relationships
get_card_parents
- Get a list of parent cards for a specific cardget_card_parent
- Check if a card is a parent of a given cardadd_card_parent
- Make a card a parent of a given cardremove_card_parent
- Remove the link between a child card and a parent cardget_card_parent_graph
- Get a list of parent cards including their parent cards tooget_card_children
- Get a list of child cards of a specified parent card
Custom Field Management
get_custom_field
- Get details of a specific custom field by ID
Workflow & Cycle Time Analysis
get_workflow_cycle_time_columns
- Get workflow's cycle time columnsget_workflow_effective_cycle_time_columns
- Get workflow's effective cycle time columns
User Management
list_users
- Get all usersget_user
- Get user detailsget_current_user
- Get current logged user details
System
health_check
- Check API connectionget_api_info
- Get API information
Tool Summary
The BusinessMap MCP server provides 43 tools across 7 categories:
Workspace Management: 3 tools
Board Management: 9 tools
Card Management: 23 tools (organized in 6 subcategories)
Custom Field Management: 1 tool
Workflow & Cycle Time Analysis: 2 tools
User Management: 3 tools
System: 2 tools
Key Features
Advanced Card Management
Complete CRUD operations for cards, subtasks, and relationships
Parent-child card hierarchies with full graph traversal
Outcome tracking and history for detailed progress monitoring
Linked cards management for cross-project dependencies
Custom fields and types support for flexible workflows
Comprehensive Board Operations
Multi-workspace board management with search capabilities
Column and lane (swimlane) operations for workflow customization
Board structure analysis with detailed metadata
Workflow Intelligence
Cycle time analysis with configurable column sets
Effective cycle time tracking for performance optimization
Custom field integration for enhanced reporting
Enterprise Features
Read-only mode for safe data exploration
Robust error handling with detailed error messages
Automatic connection verification with retry logic
Docker support for containerized deployments
Development
Setup Development Environment
Docker Support
Troubleshooting
Connection Issues
The server now includes automatic connection verification during startup. If you encounter connection issues:
Check your environment variables:
echo $BUSINESSMAP_API_URL echo $BUSINESSMAP_API_TOKENTest the connection manually:
chmod +x scripts/test-connection.sh ./scripts/test-connection.shCommon issues:
Invalid API URL: Ensure your URL follows the format
https://your-account.kanbanize.com/api/v2
Invalid API Token: Verify your token has the necessary permissions
Startup Process
The server now performs the following steps during initialization:
Configuration validation - Checks all required environment variables
API connection verification - Tests connectivity with up to 3 retry attempts
Authentication check - Verifies API token permissions
Server startup - Starts the MCP server only after successful connection
If the connection fails, the server will display detailed error messages and retry automatically.
Release Process
This project uses an automated release process. See RELEASE_PROCESS.md for detailed documentation.
Quick Start:
The release process automatically:
Bumps version (patch/minor/major)
Generates release notes from commits
Creates GitHub tags and releases
Publishes to NPM
Contributing
Follow conventional commit format for better release notes:
feat: add new feature fix: resolve bug docs: update documentation refactor: improve code structureEnsure all tests pass before submitting PR:
npm test npm run test:npx
License
MIT
Support
For issues and questions:
Check the Issues page
Review BusinessMap API documentation
Verify your environment configuration
Submit a new issue with detailed information
Related Projects
Model Context Protocol - Official MCP documentation
BusinessMap API Documentation - Official API reference
BusinessMap Demo API - Interactive API documentation and testing environment
MCP TypeScript SDK - Official MCP SDK
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Model Context Protocol server for BusinessMap (Kanbanize) integration. Provides comprehensive access to BusinessMap's project management features including workspaces, boards, cards, subtasks, parent-child relationships, outcomes, custom fields, and more.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that facilitates communication between ABAP systems and MCP clients, providing tools for managing ABAP objects, handling transport requests, and performing code analysis to enhance ABAP development workflows.Last updated -57MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides comprehensive control over QuickBase operations, allowing users to manage applications, tables, fields, records, and relationships through MCP tools.Last updated -261MIT License
- -securityAlicense-qualityA Model Context Protocol server that provides AI assistants with structured access to kanban board functionality for managing tasks, columns, labels, and sprints.Last updated -01MIT License