MCP Server for Slima - AI Writing IDE for Novel Authors. Works with Claude, ChatGPT, Gemini, Cursor, and any MCP-compatible AI tool.
npm install slima-mcp

MCP (Model Context Protocol) Server for Slima - AI Writing IDE for Novel Authors.
Connect your Slima books to any MCP-compatible AI tool - one server, all platforms.
| Platform | Status | Notes |
|----------|--------|-------|
| Claude Desktop | ✅ | Native MCP support |
| ChatGPT Desktop | ✅ | Developer Mode (2025.10+) |
| Gemini CLI | ✅ | Native MCP support |
| Cursor | ✅ | Native MCP support |
| VS Code | ✅ | Via MCP extensions |
| Platform | Status | Notes |
|----------|--------|-------|
| Claude.ai | ✅ | OAuth login, no token needed |
| ChatGPT Web | ✅ | OAuth login, no token needed |
> MCP became the industry standard in December 2025 when Anthropic, OpenAI, and Block co-founded the Agentic AI Foundation under the Linux Foundation.
``bash`
npm install -g slima-mcp
Or run directly with npx:
`bash`
npx slima-mcp
`bash`
slima-mcp auth
This will open your browser to authenticate with Slima. Your token will be saved automatically.
Or manually:
1. Go to Slima Settings
2. Click "Generate API Token"
3. Copy the token
If you used slima-mcp auth, the token is saved automatically. Just add:
#### Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
`json`
{
"mcpServers": {
"slima": {
"command": "npx",
"args": ["-y", "slima-mcp"]
}
}
}
That's it! No environment variables needed.
#### Cursor
Add to Cursor's MCP configuration:
`json`
{
"mcpServers": {
"slima": {
"command": "npx",
"args": ["-y", "slima-mcp"]
}
}
}
#### Gemini CLI
`bash`
gemini mcp add slima --command "npx -y slima-mcp"
Alternative: Using environment variables
If you prefer to use environment variables instead of slima-mcp auth:
`json`
{
"mcpServers": {
"slima": {
"command": "npx",
"args": ["-y", "slima-mcp"],
"env": {
"SLIMA_API_TOKEN": "slima_your_token_here"
}
}
}
}
Get your token from Slima Settings.
After saving the configuration, restart the application to load Slima MCP.
---
For web-based AI tools like Claude.ai and ChatGPT, use our hosted Remote MCP Server.
1. In your AI tool, add a new MCP server
2. Enter the URL: https://slima-mcp.workers.dev/mcp
3. Click "Connect" - you'll be redirected to Slima
4. Log in (or sign up) and click "Allow"
5. Done! No token copying needed
``
┌─────────────────────────────────────────────────────────┐
│ Claude.ai / ChatGPT Web │
│ │
│ 1. Click "Connect MCP Server" │
│ 2. Enter: https://slima-mcp.workers.dev/mcp │
│ ↓ │
│ 3. Redirect to Slima login │
│ ↓ │
│ 4. Approve authorization │
│ ↓ │
│ 5. Automatically connected! │
│ │
│ No API tokens. No configuration. Just works. │
└─────────────────────────────────────────────────────────┘
- OAuth 2.0 + PKCE: Industry-standard secure authentication
- No Secrets Stored: The server never stores your credentials
- Session-Based: Your token is stored securely in Cloudflare KV
- Revocable: Revoke access anytime from Slima Settings
---
| Tool | Description |
|------|-------------|
| create_book | Create a new book in your library |list_books
| | List all books in your Slima library |get_book
| | Get details of a specific book |get_book_structure
| | Get the file/folder structure of a book |get_writing_stats
| | Get writing statistics for a book |
| Tool | Description |
|------|-------------|
| read_file | Read content of any file by path |edit_file
| | Edit specific text using search & replace |write_file
| | Replace entire content of a file |create_file
| | Create a new file in a book |delete_file
| | Delete a file from a book |append_to_file
| | Append content to end of a file |search_content
| | Search for text across all files |
| Tool | Description |
|------|-------------|
| list_personas | List available beta reader personas |analyze_chapter
| | Get AI beta reader feedback on a chapter |
Once configured, you can ask your AI:
Book & Content:
- "Create a new book called 'My Novel'"
- "List my books in Slima"
- "Show me the structure of my novel"
- "Read chapter 3 of my book"
- "What are my writing stats?"
File Operations:
- "Read the character profile for my protagonist"
- "Edit chapter 1 and change 'John' to 'James'"
- "Create a new file called worldbuilding.md with notes about the magic system"
- "Search for all mentions of 'blue eyes' in my book"
- "Append this new paragraph to chapter 5"
AI Feedback:
- "Get feedback on chapter 5 from a young reader perspective"
- "Analyze my opening scene from a critic's perspective"
`bash`
slima-mcp auth # Authenticate with browser (recommended)
slima-mcp status # Check authentication status
slima-mcp logout # Remove saved credentials
slima-mcp --help # Show help
slima-mcp --version # Show version
Token is stored in ~/.slima/credentials.json with secure permissions.
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| SLIMA_API_TOKEN | No* | - | Your Slima API token |SLIMA_API_URL
| | No | https://api.slima.ai | API endpoint (for development) |DEBUG
| | No | false | Enable debug logging |
*Not required if you used slima-mcp auth
`bashClone the repository
git clone https://github.com/slima-ai/slima-mcp.git
cd slima-mcp
$3
`bash
Build the Worker
npm run build:workerRun Worker locally
npm run dev:workerDeploy to Cloudflare
npm run deploy:workerDeploy to preview environment
npm run deploy:worker:preview
`$3
`
slima-mcp/
├── src/
│ ├── core/ # Shared core modules
│ │ ├── api/ # Slima API Client
│ │ ├── tools/ # MCP Tool implementations
│ │ └── utils/ # Utilities and errors
│ ├── cli/ # CLI entry point (stdio transport)
│ │ ├── index.ts # CLI main
│ │ ├── auth.ts # Authentication commands
│ │ └── server.ts # MCP Server for CLI
│ └── worker/ # Cloudflare Worker (HTTP transport)
│ ├── index.ts # Worker entry point
│ └── oauth.ts # OAuth 2.0 + PKCE client
├── wrangler.toml # Cloudflare Worker config
├── tsup.config.ts # CLI build config
└── tsup.worker.config.ts # Worker build config
``- API tokens are stored locally and never shared
- All communication with Slima API uses HTTPS
- Tokens can be revoked anytime from Slima settings
MIT
- Slima Website
- Slima App
- MCP Documentation
- Report Issues