Vimango

This MCP server lets Claude Desktop create and organize Vimango notes directly in your local Vimango databases during chats. It handles note creation, folders, and context assignment, then relies on Vimango’s normal sync to finalize IDs and update fast search data for quick retrieval.

How to use

You connect an MCP client to the Vimango MCP server to create notes from conversations. Start the server locally, then configure your MCP client to point to it. Notes you create via the client are stored in Vimango and will be fully indexed after Vimango’s regular synchronization.

Key capabilities you’ll use include creating notes with a title and markdown content, and organizing them by contexts and folders. Notes are created with a placeholder tid that Vimango fills in during the sync process. The full-text search index is updated as part of Vimango’s normal sync workflow.

How to install

Prerequisites you need before starting:

• Python 3.11 or higher

• UV package manager

• Vimango application with configured databases

# Install and prepare the MCP server environment
cd /home/slzatz/vimango_mcp
# Create or update the virtual environment and install dependencies using UV
uv sync

# Configure database paths
cp config.json.example config.json
# Edit config.json to point to your vimango databases

Additional setup and configuration

Create a configuration file that points the MCP server to your local Vimango databases. Use the example below as a guide and customize the paths to your environment.

{
  "vimango": {
    "main_db": "/path/to/vimango.db",
    "fts_db": "/path/to/fts5_vimango.db"
  }
}

Run the MCP server

Start the MCP server locally so Claude Desktop can connect to it.

uv run vimango-mcp

Claude Desktop configuration

In Claude Desktop you add an MCP server with the following command path to run the server locally.

{
  "mcpServers": {
    "vimango": {
      "command": "/path/to/vimango_mcp/.venv/bin/vimango-mcp",
      "args": []
    }
  }
}

Notes on usage and behavior

• The MCP server creates new notes with tid left NULL. Vimango assigns the real tid during sync.

• Full-text search data (FTS) is updated during Vimango’s normal sync process, not immediately when notes are created.

• By default, research notes are created in the 'research' folder, aligning with how Vimango organizes content.

Development and testing tips

To run the test suite during development, execute the following.

uv run pytest

Available tools

create_note

Create a new Vimango note with a title and markdown body in a selected folder and context.

list_contexts

List available contexts for note categorization to help organize notes.

list_folders

List available folders to organize notes within Vimango.