by edicarloslds
Manage projects efficiently with BusinessMap's kanban boards. Track cards, analyze cycles, and streamline workflows—perf
Connects to BusinessMap's Kanban platform to manage projects, cards, workflows, and track metrics. Provides comprehensive access to all BusinessMap features through 56 tools.
BusinessMap is a community-built MCP server published by edicarloslds that provides AI assistants with tools and capabilities via the Model Context Protocol. Manage projects efficiently with BusinessMap's kanban boards. Track cards, analyze cycles, and streamline workflows—perf
You can install BusinessMap in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
BusinessMap is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Add new capabilities to Claude beyond text generation
Example
Access external data sources, execute code, interact with tools and services
Transform Claude from chatbot to action-taking agent
Provide Claude with access to relevant context and data
Example
Load project documentation, access knowledge bases, query databases
Get more accurate, context-aware responses
Automate multi-step workflows combining AI and external tools
Example
Research → Summarize → Create document → Send notification
Complete complex tasks end-to-end without manual steps
Share your MCP server with the developer community
We wired BusinessMap into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
BusinessMap has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
According to our notes, BusinessMap benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
We wired BusinessMap into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
According to our notes, BusinessMap benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
BusinessMap is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
We wired BusinessMap into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
BusinessMap is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
BusinessMap has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Useful MCP listing: BusinessMap is the kind of server we cite when onboarding engineers to host + tool permissions.
showing 1-10 of 36
Model Context Protocol server for BusinessMap (Kanbanize) integration. Provides comprehensive access to BusinessMap's project management features through 56 tools, 5 resources, and 4 guided prompts — covering workspaces, boards, cards, subtasks, parent-child relationships, outcomes, comments, tags, stickers, predecessors, custom fields, and more.
You can run the BusinessMap MCP server directly using npx without installing it globally:
npx @edicarlos.lds/businessmap-mcp
npm install -g @edicarlos.lds/businessmap-mcp
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)LOG_LEVEL: Set logging verbosity - 0 (DEBUG), 1 (INFO), 2 (WARN), 3 (ERROR), 4 (NONE) (optional, defaults to 1)PORT: Server port for HTTP mode (optional, defaults to 3000)TRANSPORT: Set to stdio (default) or httpALLOWED_ORIGINS: Comma-separated CORS origin allowlist for HTTP mode (optional, defaults to http://localhost)ALLOWED_HOSTS: Comma-separated Host header allowlist for HTTP mode DNS rebinding protection (optional)When running locally (e.g., via npx or npm start), the server will automatically look for a .env file in your current working directory.
# Create a .env file
echo "BUSINESSMAP_API_TOKEN=your_token" > .env
echo "BUSINESSMAP_API_URL=https://..." >> .env
# Run the server
npx @edicarlos.lds/businessmap-mcp
Config file location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonOpen it via Settings → Developer → Edit Config, then add:
{
"mcpServers": {
"businessmap": {
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"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": "1"
}
}
}
}
Note: Fully quit and restart Claude Desktop after editing (on macOS, quit from the Dock; on Windows, exit from the system tray). JSON does not support comments — remove any before saving.
Run the following command to add the server globally or per-project:
# Add globally (available across all projects)
claude mcp add --transport stdio --scope user businessmap -- npx -y @edicarlos.lds/businessmap-mcp
# Add to current project only (stored in ~/.claude.json)
claude mcp add --transport stdio businessmap -- npx -y @edicarlos.lds/businessmap-mcp
To pass environment variables:
claude mcp add --transport stdio \
--env BUSINESSMAP_API_TOKEN=your_token_here \
--env BUSINESSMAP_API_URL=https://your-account.kanbanize.com/api/v2 \
businessmap -- npx -y @edicarlos.lds/businessmap-mcp
Alternatively, commit a .mcp.json file to your project root to share it with your team:
{
"mcpServers": {
"businessmap": {
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"BUSINESSMAP_API_TOKEN": "${BUSINESSMAP_API_TOKEN}",
"BUSINESSMAP_API_URL": "${BUSINESSMAP_API_URL}"
}
}
}
}
Tip: Use environment variable expansion (
${VAR}) in.mcp.jsonto avoid hardcoding secrets in source control.
Create or edit ~/.cursor/mcp.json (global) or .cursor/mcp.json at the project root (project-specific):
{
"mcpServers": {
"businessmap": {
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"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": "1"
}
}
}
}
You can also manage servers via Settings → Features → MCP in the Cursor UI.
VS Code uses "servers" as the top-level key (not "mcpServers"). Create or edit .vscode/mcp.json in your project root (workspace-scoped, safe to commit), or the user-level config at:
~/Library/Application Support/Code/User/mcp.json%APPDATA%\Code\User\mcp.json{
"inputs": [
{
"type": "promptString",
"id": "businessmap-token",
"description": "BusinessMap API Token",
"password": true
}
],
"servers": {
"businessmap": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"BUSINESSMAP_API_TOKEN": "${input:businessmap-token}",
"BUSINESSMAP_API_URL": "https://your-account.kanbanize.com/api/v2",
"BUSINESSMAP_READ_ONLY_MODE": "false",
"BUSINESSMAP_DEFAULT_WORKSPACE_ID": "1"
}
}
}
}
Note: The
inputsblock lets VS Code prompt you for secrets at runtime instead of hardcoding them. Requires the GitHub Copilot Chat extension. Add via Command Palette:MCP: Add Server.
Edit ~/.codeium/windsurf/mcp_config.json (open from the Cascade panel's MCPs icon → Configure):
{
"mcpServers": {
"businessmap": {
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"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": "1"
}
}
}
}
Tip: Windsurf supports
${env:VARIABLE_NAME}syntax insideenvvalues to reference host environment variables.
MCP servers are configured inside Zed's main settings file (~/.config/zed/settings.json) under the context_servers key. Open it via Zed → Settings or Cmd+,:
{
"context_servers": {
"businessmap": {
"source": "custom",
"command": "npx",
"args": ["-y", "@edicarlos.lds/businessmap-mcp"],
"env": {
"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": "1"
}
}
}
}
You can also add servers via the Agent Panel's Settings view (Add Custom Server). A green indicator dot in the Agent Panel confirms the server is running.
For any other MCP-compatible client, configure a stdio server with:
npx -y @edicarlos.lds/businessmap-mcpBUSINESSMAP_API_TOKEN, BUSINESSMAP_API_URLBUSINESSMAP_READ_ONLY_MODE, BUSINESSMAP_DEFAULT_WORKSPACE_ID, LOG_LEVELYou can run the server as a remote MCP endpoint over Streamable HTTP. This is useful for deploying to cloud providers or using clients that support remote MCP connections.
Start the server in HTTP mode:
export TRANSPORT=http
export PORT=3000
export ALLOWED_ORIGINS=https://your-client.example.com
export ALLOWED_HOSTS=your-server.example.com
npm start
Connect your client:
Configure your MCP client to connect to the Streamable HTTP endpoint:
http://your-server:3000/mcpClone this repository:
git clone https://github.com/edicarloslds/businessmap-mcp.git
cd businessmap-mcp
Install dependencies:
npm install
Create 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=1
Note: When using as an MCP server with Claude Desktop, you don't need a
.envfile. Configure the environment variables directly in your MCP client configuration instead.
Build the project:
npm run build
Start the server:
npm start
The BusinessMap MCP server provides tools, resources, and prompts for comprehensive project management integration.
list_workspaces - Get all workspacesget_workspace - Get workspace detailsPrerequisites
Time Estimate
15-60 minutes depending on server complexity
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
Model Context Protocol standardizes how AI hosts (Claude, Cursor) communicate with external tools and data sources through server implementations.
Protocols
Compatibility
✓ Use when
Use when you need Claude to access external data, execute actions, or integrate with tools. Best for extending AI capabilities beyond conversation.
✗ Avoid when
Avoid when native integrations exist (use official APIs directly), for real-time critical systems, or when security/compliance requires zero external dependencies.