beginner⏱️ 10-20 minutes📅 Updated June 2026

Step-by-step guide to integrate Anytype MCP server with Roo Code. Enhanced Roo Code functionality with Anytype integration.

Anytype + Roo Code: Complete MCP Integration

Anytype is a MCP server that An MCP server enabling AI assistants to interact with Anytype - a local and collaborative wiki - to organize objects, lists, and more through natural language..

When integrated with Roo Code, you can:

  • Access Anytype functionality through Roo Code

This guide provides step-by-step instructions to set up Anytype in Roo Code, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

  • Anytype will be fully integrated and operational
  • You can use Anytype tools directly in Roo Code
  • All Anytype capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

  • Roo Code installed and configured
  • Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Anytype

Configuration

Step 2: Configure Roo Code

  1. Locate your configuration file:

    • Windows: %USERPROFILE%\.roo\mcp_settings.json
    • macOS: ~/.roo/mcp_settings.json
    • Linux: ~/.roo/mcp_settings.json
  2. Add server configuration:

{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": ["-y", "anytype"],
      "env": {
        
      }
    }
  }
}

  1. Restart Roo Code

Completely quit and restart Roo Code to load the new configuration.

Examples

Once configured, you can use Anytype in Roo Code:

Testing Your Setup

  1. Start a new conversation in Roo Code
  2. Ask Roo Code to list available tools
  3. Try using Anytype functionality

Test prompts:

  • "Type @ and verify Anytype appears in the tools list"
  • "Ask: "Use Anytype to help with my task""
  • "Check Roo Code output panel for server connection status"

Troubleshooting

Common Issues

MCP Server Not Connecting

Symptoms: Server not appearing in tools list, Connection timeout, MCP tools unavailable

Cause: Incorrect configuration or server not starting

Solution:

  • Verify mcp_settings.json syntax is correct
  • Check that Node.js and npx are installed and in PATH
  • View Roo Code output panel for error messages
  • Test server command manually in terminal: npx -y {server_id}
  • Ensure environment variables are properly set

Permission Denied Errors

Symptoms: Cannot execute commands, File access denied, Terminal commands blocked

Cause: Roo Code requires explicit permission for file and command operations

Solution:

  • Review and approve permission requests when prompted
  • Check VS Code workspace trust settings
  • Enable necessary permissions in Roo Code settings
  • Verify file and folder permissions on your system

API Key or Model Issues

Symptoms: Authentication failed, Model not responding, No AI completions

Cause: AI model API key not configured or invalid

Solution:

  • Verify API key is correctly set in Roo Code settings
  • Check API key has sufficient credits/quota
  • Test with a different AI model provider
  • Review Roo Code output panel for API error details

Custom Mode Not Working with MCP

Symptoms: MCP tools not available in custom mode, Mode cannot access server

Cause: Custom mode configuration does not include MCP tool permissions

Solution:

  • Edit custom mode configuration to include MCP tools
  • Add "Use MCP" to available tools in mode definition
  • Ensure mode has appropriate permissions for external tools
  • Test with default mode first to verify MCP server works

Extension Conflicts

Symptoms: Roo Code not responding, VS Code performance issues, Unexpected behavior

Cause: Conflicts with other AI coding extensions

Solution:

  • Disable other AI coding extensions (Cline, Continue, etc.)
  • Restart VS Code after disabling conflicting extensions
  • Check VS Code extension logs for conflict errors
  • Use only one AI coding assistant extension at a time

Anytype not appearing in Roo Code

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

  • Verify configuration syntax
  • Check Anytype installation
  • Restart Roo Code
  • Check logs for error messages

Next Steps

Now that Anytype is integrated with Roo Code:

  • Explore all Anytype capabilities through Roo Code
  • Check out other MCP servers that work with Roo Code
  • Join the MCP community for tips and support
  • Consider contributing to Anytype development

Need Help?

Related Resources

More Integrations

Explore other MCP servers that work with Roo Code

Need Help?

Join the MCP community for support and discussions

Anytype + Roo Code: MCP Setup Guide (2026)