AnythingLLM MCP Server

An MCP (Model Context Protocol) server that enables seamless integration between AnythingLLM and MCP-compatible clients like TypingMind, Claude Desktop, and more.

Features

• 🚀 Complete AnythingLLM API Integration: Access all AnythingLLM features through MCP
• 💬 Workspace Management: Create, update, delete, list workspaces and manage their settings
• 🤖 Chat Integration: Send messages, manage chat history, and stream responses
• 📄 Document Management: Upload, list, delete documents, process URLs, and manage vectors
• 🔍 Embedding & Search: Embed text/webpages and search within workspaces
• 👥 User Management: Create, update, delete users and manage permissions
• 🔑 API Key Management: Programmatically manage API keys
• ⚙️ System Administration: Configure LLM providers, vector databases, and system settings
• 🤖 Agent Support: Create and manage AI agents with custom prompts and tools
• 📊 System Monitoring: Access system information and statistics
• 🔐 Secure Authentication: API key-based authentication with environment variable support

Prerequisites

• Node.js 18+ installed
• AnythingLLM instance running with API access enabled
• AnythingLLM API key (obtain from your AnythingLLM instance at /settings/api-keys)

Installation

Option 1: Using npx (Recommended)

No installation needed! You can run the server directly with npx when configuring your MCP client.

Option 2: Global Installation

npm install -g anythingllm-mcp-server

Option 3: Local Installation

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

Configuration

For TypingMind.com

Setup Instructions

1. Go to TypingMind.com

2. Click on Settings → MCP Servers

3. In the MCP configuration editor, add the AnythingLLM server:

   {
    "mcpServers": {
      "anythingllm": {
        "command": "npx",
        "args": ["-y", "anythingllm-mcp-server@2.0.0"]
       }
     }
   }
   

4. Click Save - TypingMind will restart the MCP servers

5. Look for the "Connected" status

First Time Usage

After the server connects, initialize it with your AnythingLLM credentials:

1. In the chat, type:

   Use the initialize_anythingllm tool with apiKey: "your-api-key" and baseUrl: "http://localhost:3001"
   

2. Replace:

   • "your-api-key" with your AnythingLLM API key (get it from AnythingLLM → Settings → API Keys)
   • "http://localhost:3001" with your AnythingLLM instance URL

3. You'll see: "AnythingLLM client initialized successfully"

Example Commands

After initialization, use natural language to interact with AnythingLLM:

• "List all my workspaces"
• "Create a new workspace called 'Project Documentation'"
• "Chat with the 'research' workspace about the latest findings"
• "Show me all documents in the 'knowledge-base' workspace"

TypingMind will automatically use the appropriate AnythingLLM tools.

For Claude Desktop

Add to your Claude Desktop configuration file:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "anythingllm": {
      "command": "npx",
      "args": ["-y", "anythingllm-mcp-server@1.0.3"]
    }
  }
}

Initialization

When first using the server in your MCP client, you'll need to initialize it with your AnythingLLM credentials by calling the initialize_anythingllm tool:

Use the initialize_anythingllm tool with apiKey: "your-api-key" and baseUrl: "http://localhost:3001"

• apiKey: Get this from your AnythingLLM instance at /settings/api-keys
• baseUrl: Your AnythingLLM instance URL (default: http://localhost:3001)

You can also set these as environment variables:

• ANYTHINGLLM_API_KEY: Your API key
• ANYTHINGLLM_BASE_URL: Your instance URL

Available Tools

Initialization

Tool	Description	Parameters
initialize_anythingllm	Initialize the AnythingLLM client with API credentials	apiKey (string), baseUrl (optional string)

Workspace Management

Tool	Description	Parameters
list_workspaces	Get all workspaces	None
get_workspace	Get details of a specific workspace	slug (string)
create_workspace	Create a new workspace	name (string)
update_workspace	Update workspace settings	slug (string), updates (object)
delete_workspace	Remove a workspace	slug (string)
get_workspace_settings	Get settings for a specific workspace	slug (string)
update_workspace_settings	Update workspace-specific settings	slug (string), settings (object)

Chat Operations

Tool	Description	Parameters
chat_with_workspace	Send messages to a workspace	slug (string), message (string), mode (optional: "chat" or "query")
get_chat_history	Get chat history for a workspace	slug (string), limit (optional number)
clear_chat_history	Clear all chat history for a workspace	slug (string)

Document Management

Tool	Description	Parameters
list_documents	View all documents in a workspace	slug (string)
delete_document	Remove a document from a workspace	slug (string), documentId (string)
process_document_url	Process a document from a URL	slug (string), url (string)
get_document_vectors	Get vector embeddings for a document	slug (string), documentId (string)

Embedding & Search

Tool	Description	Parameters
embed_text	Embed text directly into a workspace	slug (string), texts (array of strings)
embed_webpage	Embed a webpage into a workspace	slug (string), url (string)
search_workspace	Search within a workspace	slug (string), query (string), limit (optional number)

User Management

Tool	Description	Parameters
list_users	List all users in the system	None
create_user	Create a new user	username (string), password (string), role (optional string)
update_user	Update an existing user	userId (string), updates (object)
delete_user	Delete a user	userId (string)

API Key Management

Tool	Description	Parameters
list_api_keys	List all API keys	None
create_api_key	Create a new API key	name (string)
delete_api_key	Delete an API key	keyId (string)

System Administration

Tool	Description	Parameters
get_system_settings	View system configuration	None
update_system_settings	Modify system settings	settings (object)
get_system_info	Get general system information	None
get_system_stats	Get system statistics	None

LLM Provider Management

Tool	Description	Parameters
list_llm_providers	List available LLM providers	None
update_llm_provider	Update LLM provider configuration	provider (string), apiKey (optional string), model (optional string)

Vector Database Management

Tool	Description	Parameters
get_vector_database_info	Get vector database configuration	None
update_vector_database	Update vector database configuration	provider (string), config (object)

Agent Management

Tool	Description	Parameters
list_agents	List all available agents	None
create_agent	Create a new agent	name (string), systemPrompt (optional string), tools (optional array)
update_agent	Update an existing agent	agentId (string), updates (object)
delete_agent	Delete an agent	agentId (string)
invoke_agent	Invoke an agent with input	agentId (string), input (string)

Usage Examples

Once configured, you can interact with AnythingLLM through your MCP client:

List all workspaces

"Use the list_workspaces tool to show me all available workspaces"

Create a new workspace

"Create a new workspace called 'Project Documentation' using the create_workspace tool"

Chat with a workspace

"Use chat_with_workspace to ask the 'research' workspace: What are the key findings from the latest report?"

Manage documents

"List all documents in the 'knowledge-base' workspace"
"Delete document with ID 'doc123' from the 'archive' workspace"

API Reference

This MCP server connects to the following AnythingLLM API endpoints:

• /api/v1/workspaces - Workspace operations
• /api/v1/workspace/{slug}/chat - Chat functionality
• /api/v1/workspace/{slug}/documents - Document management
• /api/v1/system/settings - System configuration

For complete API documentation, visit /api/docs on your AnythingLLM instance.

Troubleshooting

Connection Issues

• ✅ Ensure your AnythingLLM instance is running and accessible
• ✅ Verify the API key has proper permissions
• ✅ Check that the base URL is correct (include http/https)
• ✅ Make sure the AnythingLLM API is enabled in your instance

API Errors

• Most errors will include descriptive messages
• Check AnythingLLM logs for detailed error information
• Ensure your API key hasn't expired
• Verify workspace slugs are correct when accessing specific workspaces

Common Issues

"Client not initialized" error:

• Make sure you've initialized the server with your API key and base URL

"Workspace not found" error:

• Check that the workspace slug is correct
• Use list_workspaces to see available workspaces

Connection refused:

• Verify AnythingLLM is running on the specified port
• Check firewall settings

Security Notes

• 🔐 Keep your API key secure and never commit it to version control
• 🔒 Use environment variables for sensitive configuration in production
• 🛡️ Restrict API key permissions to only what's needed
• ⚠️ Never share your API key publicly

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• 🐛 Issues: GitHub Issues
• 📖 AnythingLLM Docs: docs.useanything.com
• 💬 AnythingLLM Community: Discord

Acknowledgments

• AnythingLLM by Mintplex Labs
• Model Context Protocol by Anthropic
• TypingMind for MCP support

---

Made with ❤️ for the AnythingLLM community