MCP Server

Expose Omnilib tools to external AI agents via the Model Context Protocol.

Desktop only. The MCP server runs alongside the desktop app and is not available in the web app.

Omnilib includes a Model Context Protocol (MCP) server that exposes 45+ workspace tools to external AI agents. When an external agent — Claude Code, Cursor, VS Code Copilot, or others — connects to the Omnilib MCP server, it can read and write your Omnilib workspace, query memory, search papers, manage tasks, and more. Changes made by external agents appear in Omnilib's UI in real time.

Enabling the MCP Server

  1. Open Settings > AI > MCP Server
  2. Toggle Enable MCP Server on
  3. The server starts on a local port and remains running as long as the Omnilib desktop app is open

The server is disabled by default. Enable it only when you intend to connect an external agent.

Installing the MCP Package

Install the Omnilib MCP server package so external tools can discover and connect to it:

npx -y @omnilib/mcp-server

This command installs the package and outputs the configuration snippet you need for your AI client.

Supported Clients

The Settings > AI > MCP Server panel shows ready-to-copy configuration snippets for each supported client:

  • Claude Code — Copy the config and add it to your ~/.claude/settings.json
  • Cursor — Copy and add to .cursor/mcp.json in your project
  • VS Code — Copy and add to .vscode/mcp.json
  • Windsurf — Copy and add to ~/.codeium/windsurf/mcp_config.json
  • OpenCode — Copy and add to ~/.opencode/config.json
  • Codex — Copy and add to your Codex configuration
  • Zed — Copy and add to ~/.config/zed/settings.json

Each snippet is pre-populated with your local server address and port. Click the copy icon next to any client to copy its snippet to the clipboard.

Available Tools

External agents connected via MCP have access to the following Omnilib tools:

Calendar

  • calendar_create_event — Create a calendar event
  • calendar_update_event — Update an existing event
  • calendar_delete_event — Delete an event
  • calendar_list_events — List events in a date range

Todos

  • todo_create — Create a todo item
  • todo_update — Update a todo item
  • todo_delete — Delete a todo item
  • todo_list — List todo items with optional filters

Notes

  • notes_create — Create a note
  • notes_read — Read a note by ID or title
  • notes_update — Update a note
  • notes_delete — Delete a note

Diagrams

  • mermaid_create — Create a Mermaid diagram and render it in Omnilib

Countdowns

  • countdown_create — Create a countdown timer for a date
  • countdown_list — List active countdowns

Quick Links

  • quicklinks_add — Add a quick link to the workspace
  • quicklinks_list — List saved quick links

Reminders

  • reminder_create — Create a reminder with a time and message
  • reminder_list — List pending reminders

Email

  • email_compose — Compose an email draft
  • email_send — Send an email
  • email_read — Read emails from connected accounts

Search

  • semantic_search — Semantic vector search across project files and notes

LaTeX

  • latex_compile — Compile a .tex file and return the result or errors

Memory

  • memory_query — Query the project knowledge graph with a natural language question
  • memory_add — Add an entry to project memory

Research

  • paper_search — Search academic papers by title, author, or keywords

Files

  • file_write — Write content to a file in the project
  • file_edit — Make targeted edits to an existing file

Tags

  • tag_add — Add a tag to a file
  • tag_remove — Remove a tag from a file
  • tag_list — List tags on a file or search by tag

Notebook

  • notebook_run_cell — Execute a notebook cell and return output
  • notebook_read — Read notebook cell content and outputs
  • notebook_add_cell — Add a new cell to a notebook

Live UI Sync

Changes made by external agents through the MCP server appear in Omnilib immediately — no refresh required. If an external agent writes a file, the file tree updates and any open editor shows the new content. If it creates a todo or calendar event, it appears in the respective panel.

Related