StateLode — Claude Code MCP server: features and setup
This MCP server for Claude Code and Codex connects agents to StateLode’s shared task layer. Agents can search tasks, fetch their details and make changes.
Apache-2.0 updated 2026-07-19
claude mcp add --transport http statelode https://api.statelode.dev/mcpWhat StateLode does
StateLode gives agents a shared MCP interface for working with tasks. It exposes three tools: tasksearch to find tasks, taskget to retrieve one, and task_mutate to change it.
For clients that communicate over stdio, the statelode-bridge package forwards requests to StateLode’s hosted HTTP MCP endpoint and relays notifications back to the agent. A StateLode token is required; pass it through STATELODE_TOKEN or the MCP configuration. Keep it out of statelode.json and IDE instruction files.
The setup command adds shared rules to global instruction files for installed IDEs. Run init <project-slug> to link a repository to a StateLode project and update its agent instruction files. For Cursor and VS Code, setup prints a rules block to add in the app settings.
What it helps with
- search the shared StateLode task list
- fetch details for a selected task
- change a task through an MCP tool
- link a repository to a StateLode project
Example prompts for the agent
- Find the StateLode task about authentication.
- Fetch the details for the task named “Update API”.
- Link this repository to the
my-projectproject.
How to install StateLode
1Platform CLI: remote server
claude mcp add --transport http statelode https://api.statelode.dev/mcp2Platform CLI
claude mcp add --env STATELODE_TOKEN=<STATELODE_TOKEN> --transport stdio statelode -- npx -y statelode-bridgeReplace <…> with your own values
1Platform CLI: remote server
codex mcp add statelode --url https://api.statelode.dev/mcp2Platform CLI
codex mcp add statelode --env STATELODE_TOKEN=<STATELODE_TOKEN> -- npx -y statelode-bridgeReplace <…> with your own values
Config file
{
"mcpServers": {
"statelode": {
"url": "https://api.statelode.dev/mcp"
}
}
}{
"mcpServers": {
"statelode": {
"command": "npx",
"args": [
"-y",
"statelode-bridge"
],
"env": {
"STATELODE_TOKEN": "<STATELODE_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"statelode": {
"type": "http",
"url": "https://api.statelode.dev/mcp"
}
}
}{
"servers": {
"statelode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"statelode-bridge"
],
"env": {
"STATELODE_TOKEN": "<STATELODE_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http statelode https://api.statelode.dev/mcp2Platform CLI
gemini mcp add -e STATELODE_TOKEN=<STATELODE_TOKEN> statelode npx -y statelode-bridgeReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about StateLode
How do I install StateLode in Claude Code?
Add it over stdio with claude mcp add --env STATELODE_TOKEN=<STATELODE_TOKEN> --transport stdio statelode -- npx -y statelode-bridge. Set STATELODE_TOKEN to a valid StateLode token.
What does StateLode do?
It connects an agent to a shared task system through MCP. The agent can search for tasks, retrieve task details and change tasks.
What does StateLode need to run?
It requires a StateLode token, supplied through STATELODE_TOKEN or the MCP configuration. The stdio connection uses the statelode-bridge package.