
Neo-mcp
from JavOrraca
Neo is the first autonomous AI engineering agent that plans, researches and executes multi-step work for tasks such as building AI agents, AI model fine-tuning and evals, and ML pipelines; using your codebase, data, and experiments to ship faster with inspectable artifacts. It can reason over your repository, wire tools and retrieval, debug training runs, and help you develop production-ready AI workflows
NEO MCP
NEO MCP connects your AI editor to NEO - an autonomous AI engineering agent - via the Model Context Protocol. Submit long-running tasks (fine-tuning, RAG pipelines, benchmarking, evals) directly from Claude Code, Cursor, Windsurf, VS Code, or any MCP-compatible editor, and get results synced back to your project folder.
-
Homepage: https://heyneo.com
-
Install:
pip install neo-mcp -
Tags: AI Agents, Developer Tools, Machine Learning, Task Automation, LLM, Fine-tuning
About
NEO is an autonomous AI engineering agent that plans, researches, and executes multi-step ML and AI engineering work, including fine-tuning, quantization, benchmarking, evals, and agentic pipeline construction, using your codebase, data, and experiments.
The neo-mcp package runs a local MCP server that bridges any MCP-compatible editor to the NEO backend. Tasks run autonomously and results are written back to your workspace.
Supported editors: Claude Code, Cursor, Windsurf, VS Code, Zed, Continue, Codex CLI, Antigravity
MCP Tools
Tool What it does
neo_submit_task Start a NEO task; returns a thread_id. Optional wait_for_completion blocks until done.
neo_task_status Poll task status (RUNNING, COMPLETED, WAITING_FOR_FEEDBACK, etc.).
neo_get_messages Read the task transcript after completion.
neo_list_tasks List recent or active tasks.
neo_send_feedback Reply when NEO is waiting for user input.
neo_pause_task / neo_resume_task Pause or resume a running task.
neo_stop_task Stop and tear down a task.
neo_add_integration Store a provider key (GitHub, HuggingFace, Anthropic, OpenRouter, or any custom secret) locally for use in tasks.
neo_list_integrations List configured providers (names only, never the secret).
neo_test_integration Validate a stored key against the provider's API.
neo_remove_integration Delete a stored key.
Typical flow: neo_submit_task -> poll neo_task_status -> neo_get_messages (or use wait_for_completion to skip polling).
Integrations
Give NEO access to external services by storing API keys locally once. Keys are injected as environment variables on every task run and never leave your machine.
Provider Credential What NEO can do with it
github Personal Access Token (ghp_...) Clone private repos, push, open PRs
huggingface Token (hf_...) Download private models and datasets
anthropic API key (sk-ant-...) Run Claude models inside tasks
openrouter API key (sk-or-...) Route through any model OpenRouter supports
Security
-
Keys are stored locally at
~/.neo/integrations/<provider>.envwith0o600permissions. -
Keys are never sent to the NEO backend, written to logs, or committed to git.
-
neo_list_integrationsreturns provider names only, never the secret itself.
NEO Research Inc. - https://heyneo.com
pip install neo-mcpInstallation
pip install neo-mcp
If you get error: externally-managed-environment, run:
python3 -m pip install --user --break-system-packages neo-mcp
Quick Start (Claude Code)
claude mcp add --scope user neo \
-e NEO_SECRET_KEY=sk-v1-YOUR_KEY \
-- python3 -m neo_mcp
Get your API key at: https://heyneo.com/dashboard
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ