KosmoKrator

productivity

Karbon MCP Integration for Claude Code

Connect Karbon to Claude Code 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 Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Karbon MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "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 Claude Code

Claude Code 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 Claude CodeClient-level gateway setup.