Built-in Connectors

Wick ships a set of built-in connectors that every downstream app inherits at boot. They use the same module shape as user-registered connectors (Connector Module) and surface through MCP via the meta-tool pattern (MCP for LLMs).

A built-in is just a regular connector that calls connectors.Register(...) (or sits inside connectors.RegisterBuiltins() / RegisterLabSamples()) instead of waiting for app.RegisterConnector in your main.go. Once registered, it follows the same lifecycle:

• Auto-seeded as one empty row on first boot.
• Listed at /manager/connectors/<key> for credentials + per-op enable.
• Reachable from an LLM via wick_list / wick_get / wick_execute.

Index

Connector	Key	Purpose	Default tier
HTTP / REST	httprest	Generic JSON REST client — GET / POST / PUT / PATCH / DELETE any path. Useful when you want an LLM to call an API you haven't wrapped in a typed connector yet.	builtin
Slack	slack	Read channels, threads, users; send / edit / delete messages; manage reactions. OAuth credentials supported on the row.	builtin
GitHub	github	Comprehensive REST coverage: repos, issues, PRs (diff/merge/create + reviews), branches, labels, files, releases, tags, search, collaborators, Actions, webhooks + health check.	plugin
Bitbucket	bitbucket	Search repos, read commits / diffs, list and create pull requests, post PR comments (top-level or inline).	plugin
Google Workspace	google_workspace	Manage Drive files, read/write Sheets, edit Docs and Slides, send and label Gmail, manage Calendar events (with Meet links), create Meet links, and read Meet recordings and transcripts — all under one Google OAuth account. 38 ops across seven Google APIs.	plugin
Playwright Browser	playwright_browser	Drive a real browser (Chromium/Firefox/WebKit/CloakBrowser) to screenshot, scrape, render PDF, evaluate JS, and run scripted multi-step flows. Supports persistent live sessions across calls.	plugin
Phoenix	phoenix	Debug LLM behaviour in Arize Phoenix — list spans by room or app_id and inspect a single span's prompt, messages, tool calls, and token usage. Read-only.	plugin
Loki	loki	Query logs and discover labels in a Grafana Loki instance via LogQL. Runs through Grafana with org + datasource pickers; pairs with Phoenix for full-stack debugging. Read-only.	plugin
Notion	notion	Official Notion REST API via an Internal Integration bot token — search, fetch (properties + markdown body), query databases, comments, users, create/update pages and databases.	plugin
Notion (Unofficial)	notion_unofficial	Notion's private web API via a token_v2 session cookie — sees everything the logged-in user can see, including embedded/filtered database views. Mostly read, with limited write.	plugin
Wick Manager	wickmanager	Read and edit wick's own apps / jobs / tools / connectors / tray lifecycle. For asking the LLM to inspect or tweak wick itself, not third-party APIs.	runtime
Workflow	workflow	Create, edit, test, simulate, and run workflows over MCP — the LLM-facing surface for the Workflows feature.	runtime
Notifications	notifications	Send a browser push notification to a subscribed user by opaque PN ID. Pairs with the per-session subscribe bell on the agents UI.	runtime
HTTPBin	httpbin	Sample plugin connector hitting httpbin.org — GET, POST, and status-code echo. No credentials; the smallest complete connector, useful as a plugin template.	plugin (sample)
CRUD CRUD	crudcrud	Demo connector wrapping the public crudcrud.com sandbox. Ships with cmd/lab only — useful as a copy-paste starting point.	lab sample

Tiers:

• builtin — registered by connectors.RegisterBuiltins(); every downstream wick app gets it for free.
• plugin — ships as a downloadable external binary under plugins/connector/. Not compiled into the wick binary; install with <app> plugin install <name>. See Connector Plugins for the full install flow.
• runtime — registered inline at boot in internal/pkg/api/server.go because the operations need runtime services (configsSvc, jobsSvc, workflow engine, …) that only exist mid-boot.
• lab sample — connectors.RegisterLabSamples() in cmd/lab only. Not present in production binaries.

Migrating from an older release? If you relied on github, bitbucket, google_workspace, or phoenix as built-in connectors (before they were moved to plugins), your existing credential rows and configurations are preserved — they are keyed by Meta.Key which is unchanged. The connector will not appear in the connector list until the plugin is installed and enabled. Run <app> plugin install github (and/or bitbucket, google_workspace, phoenix) after upgrading, then enable each from the manager UI.

Tag visibility

Every built-in is seeded with tags.Connector so it appears under the Connector group on the home page. Visibility within authenticated users follows the same tag-filter rule as user-registered connectors — see Connector Module ▶ Sharing connectors with tags.

The Wick Manager and Workflow connectors operate against in-process wick state (configs, jobs, workflow folders) and respect each subject's own access control on top of the connector-level tag filter:

• Wick Manager — every app_* and system_* op is admin-only. job_* / tool_* / connector_* ops are per-resource-tag-filtered (admin sees all; non-admin sees only resources whose tags grant access).
• Workflow — every workflow_* mutation requires admin; read ops are visible to any authenticated caller.

See also

• Connector Module — module contract, file layout, registration, wick:"..." tag grammar.
• MCP for LLMs — transport, wick_list / wick_get / wick_execute flow.
• Connector API reference — pkg/connector exported types.
• Encrypted Fields — how secret-tagged credentials are stored and round-tripped.