Can I use Affinity as a CLI?

Yes. KosmoKrator exposes a Affinity CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Affinity through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Affinity tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Affinity credentials stored?

Affinity credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Affinity MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Affinity MCP, CLI, and Lua Integration for AI Agents

Affinity integration docs for AI agents: MCP gateway setup, Affinity CLI commands, Lua API reference, credentials, and function schemas.

Affinity for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Affinity CLIHeadless setup, JSON output, direct function calls. Affinity MCPExpose selected tools to local MCP clients. Affinity LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: affinity
route_slug: affinity
package: affinity
auth_strategy: api_key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Description
`affinity.affinity_get_current_user`	Read `read`	Get the authenticated Affinity user and API permissions.
`affinity.affinity_list_contacts`	Read `read`	List persons in Affinity.
`affinity.affinity_get_contact`	Read `read`	Get a person by ID.
`affinity.affinity_create_contact`	Write `write`	Create a person using Affinity API.
`affinity.affinity_list_contact_fields`	Read `read`	List person field metadata.
`affinity.affinity_list_contact_field_values`	Read `read`	List field values on a person.
`affinity.affinity_get_contact_field_value`	Read `read`	Get a single field value on a person.
`affinity.affinity_list_contact_lists`	Read `read`	List lists where a person appears.
`affinity.affinity_list_contact_list_entries`	Read `read`	List list entries for a person.
`affinity.affinity_list_contact_notes`	Read `read`	List notes related to a person.
`affinity.affinity_list_organizations`	Read `read`	List companies in Affinity.
`affinity.affinity_get_organization`	Read `read`	Get a company by ID.
`affinity.affinity_create_organization`	Write `write`	Create a company using Affinity API.
`affinity.affinity_list_organization_fields`	Read `read`	List company field metadata.
`affinity.affinity_list_organization_field_values`	Read `read`	List field values on a company.
`affinity.affinity_get_organization_field_value`	Read `read`	Get a single field value on a company.
`affinity.affinity_list_organization_lists`	Read `read`	List lists where a company appears.
`affinity.affinity_list_organization_list_entries`	Read `read`	List list entries for a company.
`affinity.affinity_list_organization_notes`	Read `read`	List notes related to a company.
`affinity.affinity_list_opportunities`	Read `read`	List opportunities in Affinity.
`affinity.affinity_get_opportunity`	Read `read`	Get an opportunity by ID.
`affinity.affinity_list_opportunity_notes`	Read `read`	List notes related to an opportunity.
`affinity.affinity_list_lists`	Read `read`	List Affinity lists.
`affinity.affinity_get_list`	Read `read`	Get metadata for a list.
`affinity.affinity_list_list_fields`	Read `read`	List field metadata for a list.
`affinity.affinity_list_list_entries`	Read `read`	List entries on a list.
`affinity.affinity_get_list_entry`	Read `read`	Get one list entry.
`affinity.affinity_list_list_entry_fields`	Read `read`	List field values on a list entry.
`affinity.affinity_get_list_entry_field`	Read `read`	Get one field value on a list entry.
`affinity.affinity_update_list_entry_field`	Write `write`	Update one field value on a list entry.
`affinity.affinity_batch_update_list_entry_fields`	Write `write`	Batch update field values on a list entry.
`affinity.affinity_list_saved_views`	Read `read`	List saved views for a list.
`affinity.affinity_get_saved_view`	Read `read`	Get saved view metadata.
`affinity.affinity_list_saved_view_entries`	Read `read`	List entries on a saved view.
`affinity.affinity_list_notes`	Read `read`	List notes.
`affinity.affinity_get_note`	Read `read`	Get a note by ID.
`affinity.affinity_list_note_replies`	Read `read`	List replies for a note.
`affinity.affinity_list_note_persons`	Read `read`	List persons attached to a note.
`affinity.affinity_list_note_companies`	Read `read`	List companies attached to a note.
`affinity.affinity_list_note_opportunities`	Read `read`	List opportunities attached to a note.
`affinity.affinity_list_calls`	Read `read`	List call interactions.
`affinity.affinity_list_emails`	Read `read`	List email interactions.
`affinity.affinity_list_meetings`	Read `read`	List meeting interactions.
`affinity.affinity_list_chat_messages`	Read `read`	List chat message interactions.
`affinity.affinity_list_transcripts`	Read `read`	List transcripts.
`affinity.affinity_get_transcript`	Read `read`	Get a transcript by ID.
`affinity.affinity_list_transcript_fragments`	Read `read`	List fragments for a transcript.
`affinity.affinity_semantic_search`	Read `read`	Perform semantic search.
`affinity.affinity_api_get`	Read `read`	Call a safe relative Affinity API path with GET.
`affinity.affinity_api_post`	Write `write`	Call a safe relative Affinity API path with POST.
`affinity.affinity_api_put`	Write `write`	Call a safe relative Affinity API path with PUT.
`affinity.affinity_api_delete`	Write `write`	Call a safe relative Affinity API path with DELETE.