Businessmap MCP server

Connect Businessmap to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy BusinessmapBook a demo

What you can do with the Businessmap MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get card tool in Businessmap
  • Use the manage custom fields tool in Businessmap
  • Use the archive or unarchive card tool in Businessmap
  • Use the list card types tool in Businessmap
  • Use the log time tool in Businessmap
  • Use the create card tool in Businessmap

Supported Tools

get_card

Get Card

Retrieve full details of a specific card, including its properties, custom fields and optional subtasks and comments.

manage_custom_fields

Manage Custom Fields

List or update custom field values on a card. Use action "list" to see all custom fields and their current values, or "update" to set the value of a text, number, date, or link field.

archive_card

Archive or Unarchive Card

Archive or unarchive a card. Archived cards are hidden from active views but can be restored later. Use this instead of deleting when you want to preserve the card's history.

list_card_types

List Card Types

List card types and their IDs for creating or updating cards. Supply a board ID from list_boards to see types assigned to that board.

log_time

Log Time

Log time spent on a card. Allows tracking work hours or minutes with an optional comment describing the work performed.

create_card

Create Card

Create a new card on a Businessmap board. Requires board, workflow, column, and lane placement. Optionally set properties like description, owner, priority, size, color, deadline, and card type.

get_current_user

Get Current User

Identify the user associated with this API key, including their ID, name, email, and timezone.

delete_card

Delete Card

Permanently delete a card from Businessmap. This action is **irreversible**. Consider using archive or discard instead if you may need the card later.

list_cards

List Cards

List and filter cards across one or more boards. Supports filtering by board, column, lane, workflow, owner, and card type. Returns paginated results with up to 200 cards per state per page; includeArchived combines active and archived results.

list_block_reasons

List Block Reasons

List blocking reasons and their IDs. Supply a board ID from list_boards to discover reasons assigned to that board before using block_card.

manage_comments

Manage Card Comments

Create, update, or delete comments on a card. Use action "create" to add a new comment, "update" to modify an existing one, or "delete" to remove a comment.

manage_card_links

Manage Card Links

Create or remove relationships between cards. Supports parent-child relationships and relative, predecessor, and successor connections for tracking cross-team dependencies.

manage_subtasks

Manage Subtasks

Create, update, or delete subtasks on a card. Subtasks break down complex work items into smaller activities that can be assigned and tracked independently.

update_card

Update Card

Update an existing card's properties. This covers editing card details (title, description, priority, etc.) as well as moving a card to a different column, lane, workflow, or board. Only provide the fields you want to change.

get_board

Get Board Details

Retrieve detailed information about a specific board, including its workflows, columns, and lanes. Use this to understand a board's full structure before creating or moving cards.

list_boards

List Boards

List boards in your Businessmap account. Optionally filter by workspace or archived status. Returns board details including name, description, and workspace assignment.

list_users

List Users

List all users in your Businessmap account. Optionally filter to show only enabled or disabled users. Returns user IDs, names, and emails useful for assigning cards and subtasks.

list_workspaces

List Workspaces

List all workspaces in your Businessmap account. Workspaces are organizational containers that group related boards.

block_card

Block or Unblock Card

Block or unblock a card. Blocking a card signals that work is stalled, with a required reason. Use list_block_reasons to find valid reason IDs.

Connect Businessmap to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Businessmap in Metorial. In your Metorial portal, enable the Businessmap MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Businessmap tools.

Run Businessmap through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Businessmap and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Businessmap tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Businessmap

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Businessmap

Manage Kanban boards, cards, and workflows for enterprise project and portfolio management. Create, update, move, archive, and delete cards with properties like assignees, priorities, deadlines, custom fields, tags, and attachments. Organize work into workspaces and boards with configurable columns, swimlanes, and WIP limits. Break down cards into subtasks, establish parent-child and predecessor-successor relationships between work items, and manage initiatives for high-level project tracking. Add comments and attachments to cards. Manage users and roles, define custom fields, and configure OKRs with measurable outcomes. Set up webhooks for card, subtask, comment, and board events, and create business rule automations.

Frequently asked questions

Common questions about connecting Businessmap to AI agents with Metorial.

  1. How many tools does the Businessmap MCP server have?
    The Businessmap MCP server exposes 19 tools, including Get Card, Manage Custom Fields, Archive or Unarchive Card. Each one is governed and traced through Metorial.
  2. Businessmap exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Businessmap MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Businessmap and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Businessmap MCP server yourself or use the hosted gateway.

Connect Businessmap to production AI agents

See how Metorial gives your team governed access to Businessmap, with tracing and security controls built in.

Book a demoDeploy Businessmap