KosmoKrator

productivity

Karbon MCP Integration for LangGraph

Connect Karbon to LangGraph through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Karbon feedback View package source

Connect Karbon to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Karbon MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "mcpServers": {
    "kosmokrator-karbon": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=karbon",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=karbon --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Karbon instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Karbon Tools Visible to LangGraph

LangGraph sees stable MCP tool names generated from the Karbon integration catalog.

MCP toolSource functionTypeDescription
integration__karbon__karbon_list_contacts karbon.karbon_list_contacts Read List contacts in Karbon. Returns a paginated list of contacts with their names, emails, companies, and other details.
integration__karbon__karbon_get_contact karbon.karbon_get_contact Read Get a single contact from Karbon by its unique identifier. Returns full contact details including name, email, phone, company, and any associated notes.
integration__karbon__karbon_create_contact karbon.karbon_create_contact Write Create a new contact in Karbon. Provide at least a first name and last name. Optionally include email, company, and phone number.
integration__karbon__karbon_list_work_items karbon.karbon_list_work_items Read List work items in Karbon. Returns a paginated list of work items. Optionally filter by status (e.g., "Open", "InProgress", "Completed") or by assignee.
integration__karbon__karbon_get_work_item karbon.karbon_get_work_item Read Get a single work item from Karbon by its unique identifier. Returns full details including title, description, status, assignee, due date, and any associated notes.
integration__karbon__karbon_list_users karbon.karbon_list_users Read List users in the Karbon account. Returns user details including names, emails, and roles. Use this to find assignees for work items.
integration__karbon__karbon_get_current_user karbon.karbon_get_current_user Read Get the currently authenticated Karbon user. Returns the profile of the user whose access token is configured for this integration.

Related Karbon Pages

Karbon CLIUse direct JSON commands instead of MCP discovery. Karbon MCPFull gateway reference and MCP tool names. KosmoKrator for LangGraphClient-level gateway setup.