Connect an agent to Omni

Omni is a multi-tenant workspace humans and AI agents read and write together. It speaks Model Context Protocol — point any MCP client at the endpoint below, approve the workspaces it should see, and it can read and write the same files, databases, and links a human teammate sees.

MCP endpoint
HTTP transport. A request without a bearer token returns 401 with a WWW-Authenticate header pointing at the OAuth discovery documents — your client takes it from there.
https://www.maslow.tech/api/mcp

Authentication

OAuth 2.1 with PKCE, public client (no client secret), refresh tokens. The two discovery documents below are CORS-enabled JSON; an MCP client fetches them automatically after its first 401 from the endpoint above.

Grant types
authorization_code, refresh_token
PKCE method
S256
Scope
workspace.admin — granted per workspace. The human chooses which workspaces on the consent screen.

Wire up your client

Claude Code
claude mcp add --transport http omni https://www.maslow.tech/api/mcp
Claude Desktop
Settings → Connectors → Add custom connector

Paste https://www.maslow.tech/api/mcp as the URL.

claude.ai
Settings → Connectors → Add custom connector

Paste https://www.maslow.tech/api/mcp as the URL.

Cursor / any MCP client
https://www.maslow.tech/api/mcp

Use the HTTP transport. The client will discover the rest via the .well-known documents.

Tool catalog

Eighty tools in fourteen domains. Names are stable and namespaced — once installed, the client lists them via tools/list.

Workspace
Read and update the workspace, list yours, designate the workspace home file that every member can read, and toggle workspace-level settings like the MCP block.
  • workspace_get
  • workspace_update
  • workspaces_list
  • workspace_home_get
  • workspace_home_set
  • workspaces_settings_get
  • workspaces_settings_set
Groups
Workspace-scoped subsets of members. Share a file with a group and every current member inherits access; add or remove a teammate to grant or revoke at once.
  • groups_list
  • groups_get
  • groups_create
  • groups_update
  • groups_delete
  • groups_add_member
  • groups_remove_member
  • groups_list_members
Files
Create, read, edit, move, search, share, and delete the workspace's pages.
  • files_create
  • files_get
  • files_list
  • files_search
  • topics_list
  • files_update
  • files_append
  • files_prepend
  • files_replace
  • files_edit_section
  • files_move
  • files_delete
  • files_share
  • files_set_properties
  • files_unset_properties
  • files_assign_database
  • files_pin
  • files_unpin
  • files_pinned_list
Databases
Notion-style typed tables that materialize over the file tree. A database has a source (explicit attach / path-prefix scan / inline-markdown-table parse), typed properties (text, number, select, multi-select, date, url, email, phone, person, tags, files, relation, plus derived created/last-edited variants), and named views (table / board / list / gallery). Each row is a real file — its frontmatter is the typed property bag.
  • databases_create
  • databases_get
  • databases_list
  • databases_query
  • databases_update_schema
  • databases_add_row
Blocks
Block is the source of truth for file content. Each block (paragraph / heading / list / code / blockquote / wikilink / database-embed / etc.) has a stable UUID, per-block actor blame, and a version token for optimistic locking. Cite a block by id (`[[file#block-uuid]]`), edit one block without rewriting the surrounding markdown, or insert / reorder / delete blocks first-class.
  • blocks_read
  • blocks_create
  • blocks_update
  • blocks_delete
  • blocks_move
Links
The wikilink graph between files — outgoing and incoming references.
  • links_outgoing
  • links_incoming
Blobs
Private binary attachments referenced by files.
  • blobs_upload
  • blobs_get
  • blobs_list
  • blobs_delete
Connectors
Use the third-party apps (Gmail, Slack, …) the calling agent's owner has connected, acting as that user.
  • connectors_list
  • connectors_search_tools
  • connectors_execute
Members & permissions
Team membership, invitations, and per-file ACLs.
  • members_list
  • members_set_role
  • members_remove
  • invites_create
  • invites_list
  • invites_revoke
  • permissions_list
  • permissions_revoke
Agents
The calling agent's own identity, plus management of the workspace's other agents.
  • agents_me
  • agents_list
  • agents_provision
  • agents_rotate_token
  • agents_revoke
Events
Stream recent activity across the workspace.
  • events_stream
Sessions
Start and complete agent sessions — coarse units of work that group related interactions.
  • sessions_start
  • sessions_update_intent
  • sessions_complete
  • sessions_list
Research
Dispatch a background research sub-agent and read its result — so a conversational agent can kick off slow work and keep talking instead of stalling.
  • dispatch_research
  • check_task
Brain
Record corrections and external fetches; find semantically similar files; and surface insights, workflows, reorgs, and questions to a human on the output desk — then read their decisions (and answers to questions) back.
  • brain_correction
  • brain_external_fetch
  • brain_similar
  • brain_outbox_post
  • brain_outbox_list
  • brain_insights_scan

Install one against your workspace

You need a signed-in Omni account to authorize an agent. Sign in and add the connector — it walks you through the consent screen.

Open Omni