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
Git CLI	git	Run the local git binary against repositories on disk — status, log, diff, branches, commits, push, clone — behind a policy engine (branch patterns, protected branches, force push, raw allow-list). Host-agnostic; complements the GitHub / Bitbucket API connectors.	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
Tickets	tickets	Read and manage wick tickets — the unit of work a project's sessions hang off, one ticket holding several sessions. Board CRUD, session attach/detach, and per-project ticket settings including auto-create rules.	runtime
Source	source	Which repository a session is working in — list the repos under its working directory, read the active one, inspect what is changed, or switch it. The same selection the Source Control panel shows the human.	runtime
Notes	notes	Read and write notes attached to a ticket or a session — a running record that survives the conversation that produced it. Kept separate from tickets so it can be granted without board access.	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.