Less Annoying CRM

lacrm-mcp

Claude などの AI アシスタントが Less Annoying CRM アカウントを利用できるようにする MCP（Model Context Protocol）サーバーです。連絡先の検索、メモやタスクの閲覧、パイプラインの確認に加えて、必要に応じてメモ、タスク、連絡先の追加や、パイプライン項目の移動もできます。

独立した非公式プロジェクトです。 lacrm-mcp は、LACRM の公開 API v2 ドキュメントに基づき Northkeel Labs が開発しています。Less Annoying CRM とは提携関係になく、同社からの承認やサポートも受けていません。「Less Annoying CRM」と「LACRM」はそれぞれの所有者の名称であり、互換性の説明のみに使用しています。

60秒で始める

1. LACRM で Settings > Programmer API に移動し、API キーを作成します。必要な権限のみを付与してください（6つの読み取りツールには読み取り専用で十分です）。
2. uv をインストールします。初回実行時に uvx が PyPI から lacrm-mcp を取得します（または pip install lacrm-mcp を使用します）。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "lacrm": {
      "command": "uvx",
      "args": ["lacrm-mcp", "--read-only"],
      "env": { "LACRM_API_KEY": "your-api-key" }
    }
  }
}

Claude Code：

claude mcp add lacrm --env LACRM_API_KEY=your-api-key -- uvx lacrm-mcp --read-only

書き込みツールを使う場合は、--read-only を外してください。次のように尋ねてみましょう。「Acme の連絡先を検索して、最新のメモを表示して」または「今週が期限のタスクは何ですか？」

ツール

ツール	LACRM 関数	書き込み
search_contacts	GetContacts	いいえ
get_contact	GetContact	いいえ
list_contact_notes	GetNotesAttachedToContact	いいえ
list_tasks	GetTasks	いいえ
list_pipelines	GetPipelines	いいえ
list_pipeline_items	GetPipelineItems	いいえ
create_contact	CreateContact（デフォルトの所有者には GetUser を使用）	はい
add_note	CreateNote	はい
create_task	CreateTask	はい
update_pipeline_item_status	EditPipelineItem	はい

削除ツールはありません。リストツールはページあたり最大50件を返し、has_more_results を報告します。長いテキストフィールドは2,000文字で切り詰められます。

2026-11-10 に実際の Less Annoying CRM アカウントでテスト済み： 実際の MCP stdio 接続で、通常モードと読み取り専用モードの両方において、10個すべてのツールをテストしました。

読み取り専用モード

LACRM_READ_ONLY=1 を設定するか、--read-only を渡します。この場合、4つの書き込みツールは登録されません（モデルには表示されません）。また、万一呼び出された場合に書き込みを拒否する二重チェックも行います。セキュリティをさらに強化するには、読み取り専用 API キーと併用してください。

設定

変数	デフォルト	意味
LACRM_API_KEY	必須	API キー。環境変数からのみ読み取ります
LACRM_READ_ONLY	オフ	1/true を指定すると書き込みツールを無効にします
LACRM_TIMEOUT_SECONDS	20	リクエストごとのタイムアウト（1～120）
LACRM_MAX_RETRIES	3	429 の場合（読み取りでは 5xx／タイムアウトの場合も）の再試行回数。0～6

LACRM との通信方法

API v2 ドキュメントに従い、Authorization: <key> ヘッダーと {"Function": "...", "Parameters": {...}} の JSON 本文を付けて https://api.lessannoyingcrm.com/v2/ に POST します。HTTP 400 レスポンスには ErrorCode とエラーの説明が含まれ、秘密情報を伏せたうえで表示されます。ドキュメントにはレート制限の記載がないため、HTTP 429 の場合は指数バックオフでクライアントが再試行します（Retry-After が送信された場合はそれに従い、最大30秒に制限します）。最終エラーには待機時間が記載されます。重複レコードの作成を避けるため、書き込みは 5xx やタイムアウトの場合に再試行されません。

セキュリティに関する注意

SECURITY.md を参照してください。要点として、CRM のテキストはモデルに対する信頼できない入力であるため、結果のサイズを制限し、データとして明示します。書き込みアクセスはオプトイン方式で範囲を限定し、キーが環境の外に出たり、ログやエラーに表示されたりすることはありません。クライアントで書き込み操作を承認する前に、アシスタントが提案した内容を確認してください。

開発

uv sync --extra dev      # or: python -m venv .venv && pip install -e '.[dev]'
uv run pytest            # all HTTP is mocked; no network or API key needed

Python 3.11 以降と MCP Python SDK 1.x（FastMCP を提供する mcp<2）が必要です。

ライセンス

MIT です。LICENSE を参照してください。