Can I use Fellow as a CLI?

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

Can I expose Fellow through MCP?

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

Where are Fellow credentials stored?

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

Can I deny write access for Fellow MCP tools?

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

productivity

Fellow CLI for AI Agents

Use the Fellow CLI from KosmoKrator to call Fellow tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Fellow CLI Setup

Fellow can be configured headlessly with `kosmokrator integrations:configure fellow`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure fellow --set api_key="$FELLOW_API_KEY" --set subdomain="$FELLOW_SUBDOMAIN" --enable --read allow --write ask --json
kosmokrator integrations:doctor fellow --json
kosmokrator integrations:status --json

Runtime Requirements

Install these host dependencies before calling Fellow locally.

Name	Type	Description
`runtime`	dependency

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`FELLOW_API_KEY`	Secret `secret`	yes	API Key
`subdomain`	`FELLOW_SUBDOMAIN`	Text `text`	yes	Workspace Subdomain
`url`	`FELLOW_URL`	URL `url`	no	API Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call fellow.fellow_get_current_user '{}' --json

Provider shortcut

kosmo integrations:fellow fellow_get_current_user '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs fellow --json
kosmo integrations:docs fellow.fellow_get_current_user --json
kosmo integrations:schema fellow.fellow_get_current_user --json
kosmo integrations:search "Fellow" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`fellow.fellow_get_current_user`

Get the profile of the currently authenticated Fellow user. Returns name, email, and account details.

Read read

Parameters: none

Generic call

kosmo integrations:call fellow.fellow_get_current_user '{}' --json

Shortcut

kosmo integrations:fellow fellow_get_current_user '{}' --json

`fellow.fellow_list_notes`

List Fellow notes with optional filters, includes, and pagination.

Read read

Parameters: payload, pagination, include, filters

Generic call

kosmo integrations:call fellow.fellow_list_notes '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","filters":"example_filters"}' --json

Shortcut

kosmo integrations:fellow fellow_list_notes '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","filters":"example_filters"}' --json

`fellow.fellow_get_note`

Retrieve a Fellow note by ID.

Read read

Parameters: note_id

Generic call

kosmo integrations:call fellow.fellow_get_note '{"note_id":"example_note_id"}' --json

Shortcut

kosmo integrations:fellow fellow_get_note '{"note_id":"example_note_id"}' --json

`fellow.fellow_delete_note`

Delete a Fellow note by ID. This endpoint requires a privileged Fellow API key.

Write write

Parameters: note_id

Generic call

kosmo integrations:call fellow.fellow_delete_note '{"note_id":"example_note_id"}' --json

Shortcut

kosmo integrations:fellow fellow_delete_note '{"note_id":"example_note_id"}' --json

`fellow.fellow_list_action_items`

List action items from Fellow. Supports cursor-based pagination and optional status filtering. Returns action item titles, assignees, due dates, and completion status.

Read read

Parameters: payload, pagination, include, order_by, filters

Generic call

kosmo integrations:call fellow.fellow_list_action_items '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","order_by":"example_order_by","filters":"example_filters"}' --json

Shortcut

kosmo integrations:fellow fellow_list_action_items '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","order_by":"example_order_by","filters":"example_filters"}' --json

`fellow.fellow_get_action_item`

Retrieve a Fellow action item by ID.

Read read

Parameters: action_item_id

Generic call

kosmo integrations:call fellow.fellow_get_action_item '{"action_item_id":"example_action_item_id"}' --json

Shortcut

kosmo integrations:fellow fellow_get_action_item '{"action_item_id":"example_action_item_id"}' --json

`fellow.fellow_mark_action_item_complete`

Mark a Fellow action item complete or incomplete.

Write write

Parameters: action_item_id, completed

Generic call

kosmo integrations:call fellow.fellow_mark_action_item_complete '{"action_item_id":"example_action_item_id","completed":true}' --json

Shortcut

kosmo integrations:fellow fellow_mark_action_item_complete '{"action_item_id":"example_action_item_id","completed":true}' --json

`fellow.fellow_archive_action_item`

Archive a Fellow action item by marking it as won't do.

Write write

Parameters: action_item_id

Generic call

kosmo integrations:call fellow.fellow_archive_action_item '{"action_item_id":"example_action_item_id"}' --json

Shortcut

kosmo integrations:fellow fellow_archive_action_item '{"action_item_id":"example_action_item_id"}' --json

`fellow.fellow_list_recordings`

List Fellow recordings with optional filters, includes, pagination, and media URL settings.

Read read

Parameters: payload, pagination, include, filters, media_url

Generic call

kosmo integrations:call fellow.fellow_list_recordings '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","filters":"example_filters","media_url":"example_media_url"}' --json

Shortcut

kosmo integrations:fellow fellow_list_recordings '{"payload":"example_payload","pagination":"example_pagination","include":"example_include","filters":"example_filters","media_url":"example_media_url"}' --json

`fellow.fellow_get_recording`

Retrieve a Fellow recording by ID.

Read read

Parameters: recording_id

Generic call

kosmo integrations:call fellow.fellow_get_recording '{"recording_id":"example_recording_id"}' --json

Shortcut

kosmo integrations:fellow fellow_get_recording '{"recording_id":"example_recording_id"}' --json

`fellow.fellow_delete_recording`

Delete a Fellow recording by ID. This endpoint requires a privileged Fellow API key.

Write write

Parameters: recording_id

Generic call

kosmo integrations:call fellow.fellow_delete_recording '{"recording_id":"example_recording_id"}' --json

Shortcut

kosmo integrations:fellow fellow_delete_recording '{"recording_id":"example_recording_id"}' --json

`fellow.fellow_list_webhooks`

List Fellow webhooks with optional page size, cursor, and JSON-encoded filters.

Read read

Parameters: page_size, cursor, filters

Generic call

kosmo integrations:call fellow.fellow_list_webhooks '{"page_size":1,"cursor":"example_cursor","filters":"example_filters"}' --json

Shortcut

kosmo integrations:fellow fellow_list_webhooks '{"page_size":1,"cursor":"example_cursor","filters":"example_filters"}' --json

`fellow.fellow_create_webhook`

Create a Fellow webhook endpoint for supported event types.

Write write

Parameters: url, enabled_events, description, status

Generic call

kosmo integrations:call fellow.fellow_create_webhook '{"url":"example_url","enabled_events":"example_enabled_events","description":"example_description","status":"example_status"}' --json

Shortcut

kosmo integrations:fellow fellow_create_webhook '{"url":"example_url","enabled_events":"example_enabled_events","description":"example_description","status":"example_status"}' --json

`fellow.fellow_get_webhook`

Retrieve a Fellow webhook by ID.

Read read

Parameters: webhook_id

Generic call

kosmo integrations:call fellow.fellow_get_webhook '{"webhook_id":"example_webhook_id"}' --json

Shortcut

kosmo integrations:fellow fellow_get_webhook '{"webhook_id":"example_webhook_id"}' --json

`fellow.fellow_update_webhook`

Update a Fellow webhook endpoint with partial fields.

Write write

Parameters: webhook_id, payload, url, enabled_events, description, status

Generic call

kosmo integrations:call fellow.fellow_update_webhook '{"webhook_id":"example_webhook_id","payload":"example_payload","url":"example_url","enabled_events":"example_enabled_events","description":"example_description","status":"example_status"}' --json

Shortcut

kosmo integrations:fellow fellow_update_webhook '{"webhook_id":"example_webhook_id","payload":"example_payload","url":"example_url","enabled_events":"example_enabled_events","description":"example_description","status":"example_status"}' --json

`fellow.fellow_delete_webhook`

Delete a Fellow webhook endpoint by ID.

Write write

Parameters: webhook_id

Generic call

kosmo integrations:call fellow.fellow_delete_webhook '{"webhook_id":"example_webhook_id"}' --json

Shortcut

kosmo integrations:fellow fellow_delete_webhook '{"webhook_id":"example_webhook_id"}' --json

`fellow.fellow_api_get`

Call a relative Fellow API GET path for documented endpoints without a first-class tool.

Read read

Parameters: path, params

Generic call

kosmo integrations:call fellow.fellow_api_get '{"path":"example_path","params":"example_params"}' --json

Shortcut

kosmo integrations:fellow fellow_api_get '{"path":"example_path","params":"example_params"}' --json

`fellow.fellow_api_post`

Call a relative Fellow API POST path for documented endpoints without a first-class tool.

Write write

Parameters: path, payload

Generic call

kosmo integrations:call fellow.fellow_api_post '{"path":"example_path","payload":"example_payload"}' --json

Shortcut

kosmo integrations:fellow fellow_api_post '{"path":"example_path","payload":"example_payload"}' --json

`fellow.fellow_api_patch`

Call a relative Fellow API PATCH path for documented endpoints without a first-class tool.

Write write

Parameters: path, payload

Generic call

kosmo integrations:call fellow.fellow_api_patch '{"path":"example_path","payload":"example_payload"}' --json

Shortcut

kosmo integrations:fellow fellow_api_patch '{"path":"example_path","payload":"example_payload"}' --json

`fellow.fellow_api_delete`

Call a relative Fellow API DELETE path for documented endpoints without a first-class tool.

Write write

Parameters: path, payload

Generic call

kosmo integrations:call fellow.fellow_api_delete '{"path":"example_path","payload":"example_payload"}' --json

Shortcut

kosmo integrations:fellow fellow_api_delete '{"path":"example_path","payload":"example_payload"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

fellow.fellow_get_current_user 0 parameters

Schema command

kosmo integrations:schema fellow.fellow_get_current_user --json

Parameter	Type	Required	Description
No parameters.

fellow.fellow_list_notes 4 parameters

Schema command

kosmo integrations:schema fellow.fellow_list_notes --json

Parameter	Type	Required	Description
`payload`	object	no	Raw Fellow list body with pagination, include, and filters.
`pagination`	object	no	Pagination object.
`include`	object	no	Optional expensive fields to include.
`filters`	object	no	Note filters.

fellow.fellow_get_note 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_get_note --json

Parameter	Type	Required	Description
`note_id`	string	yes	Fellow note ID.

fellow.fellow_delete_note 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_delete_note --json

Parameter	Type	Required	Description
`note_id`	string	yes	Fellow note ID.

fellow.fellow_list_action_items 5 parameters

Schema command

kosmo integrations:schema fellow.fellow_list_action_items --json

Parameter	Type	Required	Description
`payload`	object	no	Raw Fellow list body with pagination, include, order_by, and filters.
`pagination`	object	no	Pagination object.
`include`	string	no	Optional include field.
`order_by`	string	no	Order by created_at_desc, created_at_asc, or due_date.
`filters`	object	no	Action item filters, including scope.

fellow.fellow_get_action_item 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_get_action_item --json

Parameter	Type	Required	Description
`action_item_id`	string	yes	Fellow action item ID.

fellow.fellow_mark_action_item_complete 2 parameters

Schema command

kosmo integrations:schema fellow.fellow_mark_action_item_complete --json

Parameter	Type	Required	Description
`action_item_id`	string	yes	Fellow action item ID.
`completed`	boolean	yes	Whether the action item should be complete.

fellow.fellow_archive_action_item 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_archive_action_item --json

Parameter	Type	Required	Description
`action_item_id`	string	yes	Fellow action item ID.

fellow.fellow_list_recordings 5 parameters

Schema command

kosmo integrations:schema fellow.fellow_list_recordings --json

Parameter	Type	Required	Description
`payload`	object	no	Raw Fellow list body with pagination, include, filters, and media_url.
`pagination`	object	no	Pagination object.
`include`	object	no	Optional expensive fields to include.
`filters`	object	no	Recording filters.
`media_url`	object	no	Media URL expiration configuration.

fellow.fellow_get_recording 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_get_recording --json

Parameter	Type	Required	Description
`recording_id`	string	yes	Fellow recording ID.

fellow.fellow_delete_recording 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_delete_recording --json

Parameter	Type	Required	Description
`recording_id`	string	yes	Fellow recording ID.

fellow.fellow_list_webhooks 3 parameters

Schema command

kosmo integrations:schema fellow.fellow_list_webhooks --json

Parameter	Type	Required	Description
`page_size`	integer	no	Number of results per page.
`cursor`	string	no	Pagination cursor.
`filters`	string,object	no	Webhook filters as JSON string or object.

fellow.fellow_create_webhook 4 parameters

Schema command

kosmo integrations:schema fellow.fellow_create_webhook --json

Parameter	Type	Required	Description
`url`	string	yes	Webhook destination URL.
`enabled_events`	array	yes	Event types to subscribe to.
`description`	string	no	Optional webhook description.
`status`	string	no	Webhook status.

fellow.fellow_get_webhook 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_get_webhook --json

Parameter	Type	Required	Description
`webhook_id`	string	yes	Fellow webhook ID.

fellow.fellow_update_webhook 6 parameters

Schema command

kosmo integrations:schema fellow.fellow_update_webhook --json

Parameter	Type	Required	Description
`webhook_id`	string	yes	Fellow webhook ID.
`payload`	object	no	Raw webhook update body.
`url`	string	no	Webhook destination URL.
`enabled_events`	array	no	Event types to subscribe to.
`description`	string	no	Webhook description.
`status`	string	no	Webhook status.

fellow.fellow_delete_webhook 1 parameters

Schema command

kosmo integrations:schema fellow.fellow_delete_webhook --json

Parameter	Type	Required	Description
`webhook_id`	string	yes	Fellow webhook ID.

fellow.fellow_api_get 2 parameters

Schema command

kosmo integrations:schema fellow.fellow_api_get --json

Parameter	Type	Required	Description
`path`	string	yes	Relative path such as /me. Absolute URLs are rejected.
`params`	object	no	Query parameters.

fellow.fellow_api_post 2 parameters

Schema command

kosmo integrations:schema fellow.fellow_api_post --json

Parameter	Type	Required	Description
`path`	string	yes	Relative path such as /notes. Absolute URLs are rejected.
`payload`	object	no	JSON request body.

fellow.fellow_api_patch 2 parameters

Schema command

kosmo integrations:schema fellow.fellow_api_patch --json

Parameter	Type	Required	Description
`path`	string	yes	Relative path such as /webhook/{id}. Absolute URLs are rejected.
`payload`	object	no	JSON request body.

fellow.fellow_api_delete 2 parameters

Schema command

kosmo integrations:schema fellow.fellow_api_delete --json

Parameter	Type	Required	Description
`path`	string	yes	Relative path such as /webhook/{id}. Absolute URLs are rejected.
`payload`	object	no	Optional JSON request body.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.