anythingllm

This MCP server provides a bridge between AnythingLLM and MCP-compatible clients such as TypingMind and Claude Desktop. It exposes the full AnythingLLM API via the MCP layer, including workspace management, chat interactions, document handling, embedding and search, API key management, and agent support. The server authenticates requests using an API key and can be configured to point to your running AnythingLLM instance. Once connected, MCP clients can issue the predefined tools (for example initialize_anythingllm, list_workspaces, chat_with_workspace, etc.) to manage workspaces, send messages, process documents, and retrieve embeddings.

To use it from a client, install or configure the AnythingLLM MCP server endpoint in your MCP client (e.g., TypingMind or Claude Desktop) and initialize with your AnythingLLM API key and base URL. After initialization, you can perform natural-language interactions that translate into the appropriate AnythingLLM actions, such as listing workspaces, creating a workspace, sending a chat message, or uploading documents. The server handles translation between MCP tool calls and the underlying AnythingLLM API calls, including streaming responses where supported.

Prerequisites:

• Node.js 18+ installed
• npm (comes with Node.js) or npx available
• An active AnythingLLM instance with API access and an API key

Option 1: Using npx (Recommended)

No installation needed. Run the MCP server directly with npx when configuring your MCP client.

Example:

npx -y anythingllm-mcp-server@2.0.0

Option 2: Global Installation

Install the MCP server globally and run it as a standard command:

npm install -g anythingllm-mcp-server
anythingllm-mcp-server

Option 3: Local Installation

Clone the repository (or use your own project containing the MCP server):

git clone https://github.com/yourusername/anythingllm-mcp-server.git
cd anythingllm-mcp-server
npm install

Then run locally (if the package provides a start script or bin):

npm run start

Configuration via environment variables or through MCP client settings is supported. Ensure ANYTHINGLLM_API_KEY and ANYTHINGLLM_BASE_URL are set if you initialize from the environment.

Environment variables:

• ANYTHINGLLM_API_KEY: Your API key from AnythingLLM (Settings → API Keys)
• ANYTHINGLLM_BASE_URL: Base URL of your AnythingLLM instance (default http://localhost:3001)

Common issues:

• If the MCP client cannot connect, verify that the AnythingLLM instance is reachable at the configured base URL and that the API key is valid.
• Ensure the MCP server process has network access to the AnythingLLM instance and that any required CORS or firewall settings allow communication.
• When using TypingMind, ensure the MCP server is added in Credentials/Endpoints with the correct command and arguments as shown in the README example.
• If you upgrade AnythingLLM or the MCP server, pin the version in your npx/CLI configuration to avoid breaking changes.