This guide walks you through connecting xTiles to Claude Desktop using the Model Context Protocol (MCP). Once set up, your AI tools will be able to read and work with your xTiles content directly — right from a conversation with Claude:
Read content of all your projects, tiles, and tasks across your xTiles workspaces
Add projects, pages, tiles, and text blocks inside them
Work with tasks — create, schedule, assign priorities and people
What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI tools connect directly to external apps. Instead of copy-pasting content into a chat, the AI reads your data in real time — straight from the source.
Prerequisites
Before you start, make sure you have:
An active xTiles account
MCP access enabled on your account (see Step 1)
Claude Desktop installed on your computer
Node.js installed on your computer (required to run the MCP connection)
A basic text editor (Notepad on Windows, TextEdit on Mac, or any code editor)
How to check if Node.js is installed: Open a terminal (Command Prompt on Windows, Terminal on Mac) and type node -v. If you see a version number, you're good. If not, download and install it from nodejs.org before continuing.
Step 1 — Enable MCP Access in xTiles
MCP integration is currently in beta and needs to be manually enabled for your account.
To request access: Reach out to the xTiles support team via the in-app chat or at [email protected] and ask to have MCP / API access enabled for your account.
Once enabled, you'll see a new Integrations section appear in your account settings.
To find your API token:
Open xTiles
Go to Account Settings (click your avatar or initials in the top corner)
Navigate to Integrations
Copy and save your API token — you'll need this in the next steps
⚠️ Keep your API token private. It gives full read access to your xTiles content.
Step 2 — Locate Your Claude Desktop Config File
Claude Desktop uses a JSON config file to know which MCP servers to connect to. You need to find and edit this file.
The easiest way to find the config file is directly in Claude Desktop:
Open Claude Desktop
Go to Settings (top-left menu)
Click the Developer tab
Click Edit Config — this opens the config file directly in your text editor
If you can't find it there, you can also navigate to it manually:
On Windows:
C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json
On Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
Step 3 — Edit the Config File
Open the config file in any text editor (Notepad, TextEdit, VS Code, etc.).
If the file is empty or new, paste in the following:
{
"mcpServers": {
"xtiles": {
"command": "C:\\PROGRA~1\\nodejs\\npx.cmd",
"args": [
"-y",
"mcp-remote",
"https://mcp.xtiles.app/mcp",
"--header",
"Authorization: Bearer YOUR_API_TOKEN_HERE"
]
}
}
}
If the file already has content (other MCP servers configured), add the xTiles block inside the existing "mcpServers" object:
{
"mcpServers": {
"xtiles": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.xtiles.app/mcp",
"--header",
"Authorization: Bearer YOUR_API_TOKEN_HERE"
]
}
}
}
Replace YOUR_API_TOKEN_HERE with the token you copied from xTiles Integrations settings.
Make sure the JSON is valid — no missing commas, no extra brackets. Invalid JSON will prevent Claude Desktop from loading.
Step 4 — Restart Claude Desktop
After saving the config file, fully quit and reopen Claude Desktop. This is required for the changes to take effect.
On Mac: right-click the Claude icon in the Dock → Quit, then reopen. On Windows: close the window and end the process in Task Manager if needed, then reopen.
Step 5 — Verify the Connection
Once Claude Desktop restarts:
Start a new conversation
Look for the hammer/tools icon near the chat input — this indicates MCP tools are available
Try asking Claude something like:
"What workspaces do I have in xTiles?"
"Show me my recent tasks"
"Summarize my notes from the Marketing project"
If Claude can see your xTiles content, the integration is working.
Need Help?
If you run into any issues during setup, reach out via the in-app chat or email [email protected] — the team is happy to walk you through it step by step.
You can also watch the setup overview video for a visual walkthrough of the process
Troubleshooting
I don't see the Integrations section in my account settings
I don't see the Integrations section in my account settings
MCP access needs to be manually enabled. Contact support to request it.
Claude doesn't seem to be connecting to xTiles
Claude doesn't seem to be connecting to xTiles
Double-check your JSON formatting — even one missing comma breaks it
Make sure you fully restarted Claude Desktop (not just closed the window)
Verify your API token is correct and hasn't been regenerated
I get an authentication error
I get an authentication error
Your API token may have changed. Go back to xTiles → Account Settings → Integrations and copy the current token, then update your config file.