MCP Tools and Skills Reference

Orbit MCP lets an AI client work with Orbit through permission-aware tools. Orbit skills are optional client-side guidance packages that help the client use those tools safely.

MCP tool categories

Category	Tools	Use it for
Connection check	orbit_doctor	Check connection details and available capabilities.
Workspaces	orbit_list_workspaces	List accessible Orbit workspaces.
Notes and folders	orbit_list_notes, orbit_resolve_note, orbit_get_note	Find and read notes by path, title, URL, or identifier.
Search and graph	orbit_search_notes, orbit_get_workspace_graph	Search workspace content and inspect note relationships.
Safe writes	orbit_create_note, orbit_append_to_note, orbit_patch_note	Create notes and make targeted edits.
Tables	orbit_insert_table_rows, orbit_update_table_cells, orbit_delete_table_rows, orbit_move_table_rows	Edit existing tables without replacing the whole note.
Organization	orbit_move_note, orbit_delete_note, orbit_delete_folder	Rename, move, or delete Orbit notes and folders.
Assets	orbit_upload_asset	Add a binary attachment to an existing note.
Write status	orbit_get_write_status	Check whether a long-running write was received, applied, or failed.

Tool availability may vary by client and Orbit version. Use orbit_doctor when checking a connection.

Deletion behavior

orbit_delete_note moves an Orbit note to Recently Deleted. This is a restorable soft delete, not a permanent delete.

orbit_delete_folder moves child Orbit notes to Recently Deleted before removing empty folders. Non-note files block folder deletion unless the tool call explicitly allows non-note files.

Orbit skills

Skill	Use it for
orbit-markdown	Creating or editing Orbit notes with supported formatting, wiki links, citations, diagrams, and fenced code.
orbit-ai-ready-wiki	Preparing an Orbit workspace to work well with AI clients.
orbit-source-ingest	Turning source material into cited wiki updates or candidate pages.
orbit-query-wiki	Answering questions from Orbit with citations and no writes by default.
orbit-wiki-lint	Finding unresolved links, stale pages, missing citations, duplicates, and contradictions.
orbit-safe-edits	Making safer MCP writes with confirmations and checks that reduce accidental overwrites.
orbit-meeting-notes	Converting raw meeting material into wiki-ready notes.

Install examples

npx -y @orbit/skills install claude-code
npx -y @orbit/skills install claude-chat
npx -y @orbit/skills install claude-cowork
npx -y @orbit/skills install codex
npx -y @orbit/skills install opencode

Restart the AI client after installing skills.

Safe use rules

• Skills do not grant data access.
• MCP access still follows Orbit authorization and Microsoft 365 permissions.
• Prefer append or targeted patch operations over broad replacements.
• Review AI-written changes before treating them as final.
• Use note context for narrow tasks and workspace context only when needed.